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Vorwort 


Der Commodore Amiga ist ein vielseitiger Computer. Somit fällt es vielen 
sehr schwer, diesen Rechner in die richtige Kategorie einzuordnen. Seine 
Anwendungsgebiete reichen vom professionellen Einsatz als Personal¬ 
computer im Business-Bereich bis zum idealen Rechner für Programmierer. 

Unter anderem setzt sich, nicht zuletzt des Amiga wegen, immer mehr eine 
neue Art der Programmgestaltung und der Benutzeroberfläche durch. Die 
alten, nicht bedienungsfreundlichen Programme werden nun bald der 
Geschichte angehören. Umständliche Tastaturbedienung von Programmen, 
Schwarzweiß-Grafiken oder solche mit vier Farben, Grafiken mit niedriger 
Auflösung, langsame Geschwindigkeiten und ein öder Ablauf von Pro¬ 
grammen zählen nun, dank Amiga, zur Vergangenheit. Schnelle Grafiken 
und hohe Rechengeschwindigkeiten, Mausbedienung sowie Multitasking 
beherrschen nun das Geschehen auf dem Software-Markt, nach dem sich 
jeder Hobby- oder Profiprogrammierer richten muß, wenn seine Software 
großen Zuspruch bei den Software-Anwendern finden soll. 

Wir persönlich sehen im Amiga eine faszinierende Maschine für Program¬ 
mierer, die sehr viele Reize und Geheimnisse enthält. Diese Reize und 
Geheimnisse wollen wir in diesem Buch dem Leser anhand von vielen Bei¬ 
spielen verdeutlichen. Gerade diese Programmbeispiele sehen wir in diesem 
Buch als etwas ganz Besonderes an. Es ist doch oft so, daß viel erklärt wird, 
aber ein Beispiel, das noch offene Fragen beantwortet, fehlt. Genau dieses 
Übel wollten wir mit den vielen Demonstrationsprogrammen beseitigen. Wir 
raten also jedem Leser, wenn er etwas nicht versteht, in dem zugehörigen 
Programm nachzusehen und es genau durchzuarbeiten. Da alle Programme 
auf Diskette mitgeliefert werden, als Source-Code und kompiliert, kann auch 
gleichzeitig überprüft werden, was das Programm überhaupt macht. 
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Schon oft haben wir uns ein kompaktes Buch wie dieses gewünscht, das dem 
Programmierer nicht nur zeigt, was der Rechner kann, sondern ihm auch an 
Beispielen die Anwendung der Features verdeutlicht. Die Entwicklung von 
Software der neuesten Generation dürfte somit kein Problem mehr sein. 
Leider können wir aber nicht alle Möglichkeiten des Amiga aufführen und 
erklären, da dazu zwei weitere derartige Bücher erforderlich wären. Da 
allerdings sehr viele Funktionen durch andere, kompaktere Befehle ersetzt 
werden können, beschränken wir uns auf diese, was aber keineswegs große 
Einschränkungen in der Programmierung mit sich bringt. Im Gegenteil, die 
Programmierung wird dadurch sogar erheblich vereinfacht. In diesem Buch 
sind alle Funktionen beschrieben, die der Programmierer für ein sehr gutes 
Programm benötigt. 

Da heutzutage Leistungsfähigkeit und hohe Programmgeschwindigkeiten von 
großer Bedeutung sind, hielten wir es nicht für angebracht, die Demo-Pro¬ 
gramme in BASIC zu schreiben, obwohl das Amiga-BASIC zu den Lei¬ 
stungsfähigsten seiner Klasse zählt. Da sich bei der Entwicklung von Pro¬ 
grammen und bei den Programmierern zunehmend die Programmiersprache 
C durchsetzt, wollten auch wir natürlich nicht darauf verzichten. Program¬ 
mierer, die kaum Erfahrungen mit C besitzen, brauchen aber nun nicht 
zurückzuschrecken, da die Listings dokumentiert und mehrfach von uns 
bearbeitet worden sind, so daß wir garantieren können, daß alle Programme 
auf einem Amiga-System mit mindestens 512 Kbyte laufen. 

Danken möchten wir nun noch Frau Christine Baumann für die tatkräftige 
Unterstützung und unseren Eltern für das Verständnis, das sie aufbrachten, 
wenn wir nächtelang am Computer saßen, um doch noch einige Verbesse¬ 
rungen in das Buch einzubauen. Auch Herrn Peter Wollschlaeger, der sich 
unseres Buches als Lektor annahm, gehört unser Dank. 
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Die Sprache »C« 


Auf dem Amiga hat sich die Sprache »C« als Programmiersprache für 
anspruchsvolle Programme durchgesetzt. Dies liegt vornehmlich daran, daß 
C-Programme enorm schnell, dabei aber dennoch recht einfach zu erstellen sind. 

Für die C-Anfänger gehen wir in diesem Kapitel auf die Programmierung in C 
ein. Natürlich können nicht alle Einzelheiten dargestellt werden, da dies den 
Rahmen des Buches sprengen würde. Als Einstieg dürften die Informationen 
allerdings ausreichend sein. 

Für den Amiga stehen derzeit zwei verschiedene C-Compiler zur Verfügung. 
Dies sind der Manx-Aztec- und der Lattice-C-Compiler. Der Unterschied liegt 
im Preis, bei der Bedienungsfreundlichkeit und in der Schnelligkeit und 
Kompaktheit des erzeugten Codes. Beide lassen sich leider nur vom CLI, dem 
»Command Line Interface« des Amiga, bedienen, was anfangs sehr mühsam ist. 
Wir möchten Ihnen an dieser Stelle keinen Compiler anraten, da dies schon in 
großer Zahl in den Fachzeitschriften geschehen ist. 

Die Programme haben wir auf dem Lattice-Compiler V3.10 geschrieben. Den 
Besitzern von älteren Versionen des Lattice-C-Compilcrs stehen leider noch 
nicht alle Befehle zur Verfügung, beispielsweise sind die Befehle AreaCircle 
und AreaEllipse noch nicht implementiert. Trotz der Verwendung des Lattice- 
Compilers sollten die Programme alle auch mit dem Aztec-Compiler lauffähig 
sein. Inkompatibilitäten wurden uns bisher jedenfalls nicht bekannt. Wenn Sie 
Besitzer der Lattice-Version 4.00 sein sollten, so sind die Programme auch mit 
dieser Version lauffähig, wenn Sie zum Kompilieren das später angeführte 
Batch-File verwenden. 

Zudem möchten wir jedem Programmierer dazu raten, eine Festplatte zu 
verwenden, sei es eine Amiga- oder eine PC-Harddisk im SideCar bzw. Amiga 
2000, da das Kompilieren mit Disketten äußerst zeitraubend ist, zumal diese für 
C eine nicht gerade üppige Speicherkapazität besitzen, so daß es sehr schnell zu 
Speichermangel auf den Disketten kommen kann. 

Zur Vereinfachung des Kompiliervorganges haben wir ein Batch-File 
geschrieben, das alle Kompilier- und Linkphasen selbständig durchführt: 
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Für die Lattice-Version 3.02 oder 3.03: 

stack 20000 

if not exists <prg>.c 

echo "File ist nicht vorhanden" 

skip end 

endif 

echo "— kompilieren —" 

lcl -i:include/ -i:include/lattice/ <prg>.c 
if not exists <prg>.q 
echo "Compiler-Fehler" 
quit 20 
endif 

lc2 -cdb <prg> 

alink : lib/lstartup.obj+<prg>.o library : lib/lc.lib+ 
:lib/amiga.lib to <prg> map nil: 
delete <prg>.o 

echo "— Kompilier- und Linkvorgang ist zu Ende —" 
lab end 

Für die Lattice-Version 3.10: 

stack 20000 

if not exists <prg>.c 

echo "File ist nicht vorhanden" 

skip end 

endif 

echo "— kompilieren —" 

LC1 -f -i:include/ -i:include/lattice/ <prg>.c 
if not exists <prg>.q 
echo "Compiler-Fehler" 
quit 20 
endif 

LC2 -cdb <prg> 

BLINK FROM LIB:c.o+<prg>.o TO <prg> LIB LIB:lc.lib+lcmffp.lib+ 
LIB:amiga.lib+LIB:lern.lib 

delete <prg>.o 

echo "— Kompilier- und Linkvorgang ist zu Ende —" 
lab end 

Für die Lattice-Version 4.00: 

stack 20000 

if not exists <prg>.c 

echo "File ist nicht vorhanden" 

skip end 

endif 

echo "— kompilieren —" 

LC1 -f -iiinclude/ -i:include/lattice/ <prg>.c 
if not exists <prg>.q 
echo "Compiler-Fehler" 
quit 20 
endif 
LC2 <prg> 

BLINK FROM LIB:c.o+<prg>.o TO <prg> LIB LIB:lc.lib+lcmffp.lib+ 
LIB:amiga.lib+LIB:1cm.lib 

delete <prg>.o 

echo "— Kompilier- und Linkvorgang ist zu Ende —" 
lab end 
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Dieses File muß mit dem Editor »ed« eingegeben und gespeichert werden. Dazu 
gehen Sie von der Workbench aus in das CLI. Dort erscheint »1>«. Nun 
kommen Sie mit »ed comp« in den Editor und können das Batch-File eingeben. 
Wenn Sie fertig sind, können Sie es abspeichem, indem Sie »ESC« und 
anschließend »x« drücken. Das Batch-File steht nun unter dem Namen »comp« 
auf Ihrer Diskette bzw. Harddisk. Wenn Sie später ein selbstgeschriebenes C- 
Programm kompilieren wollen, starten Sie es mit dem CLI-Befehl »EXECUTE 
comp« und dem Programmnamen des C-Programms ohne das »,c«-Kürzel. 

Nun, was bewirkt dieses Batch-File? Zu Beginn wird der Programmname der 
Variablen »prg« übergeben und anschließend der Stack auf eine Größe von 
20000 Byte gesetzt, was nötig ist, da der Compiler eine Vielzahl von Daten 
Zwischenspeichern muß. Anschließend überprüft es, ob das gewünschte Pro¬ 
gramm zum Kompilieren überhaupt existiert. Ist das Programm nicht vor¬ 
handen, steigt das Batch-File aus und druckt die Fehlermeldung »File ist 
nicht vorhanden«. Ist kein Fehler aufgetreten, so beginnen nun die 
Kompiliervorgänge »lcl« und »lc2«. »lcl« überprüft hauptsächlich die Syntax 
des Hauptprogramms und der eingeladenen Include-Files. »Ic2« generiert 
anschließend den Programmcode. Tritt beim Kompiliervorgang »lcl« ein Fehler 
auf, so wird auch hier der Ablauf des Batch-Files gestoppt und eine 
Fehlermeldung »Compiler-Fehler« ausgegeben. 

Liefen jedoch die Kompiliervorgänge ohne Fehler ab, beginnt das Programm 
mit dem Zusammenfügen, sprich »Linken«, der Bibliotheksmodule mit dem 
Programmcode. Eine Meldung teilt dem Benutzer anschließend mit, daß dieser 
Prozeß beendet ist. Danach kann das »kompilierte« und »gelinkte« Programm 
gestartet werden. Das Programm muß unter dem gewünschten Namen mit 
angehängtem ».c« erstellt und abgespeichert worden sein, also beispielsweise 
»test.c«. Nach dem Kompilier- und Linkvorgang steht der startbare 
Programmcode in der Datei »test«. Dieser Programmcode läßt sich nun einfach 
durch Eintippen des Dateinamens starten. 

Bei den meisten Programmen bietet sich auch noch die Möglichkeit an, eine 
»,info«-Datei zu kopieren, beispielsweise »copy cli.info to test.info«. Dann 
können die Programme auch von der Workbench aus gestartet werden. Eine 
Ausnahme bilden hier die Programme, die »printf«, »scanf« oder DOS-Befehle 
benutzen, da diese Befehle ihre Ein- und Ausgabe über CLI abwickeln. Aus 
diesem Grund besitzen auch nicht alle Demonstrationsprogramme auf der 
mitgelieferten Diskette sog. Icons, sind also von der Workbench aus nicht sicht- 
oder startbar. Sie können nur von CLI aus gestartet werden. Verwenden Sie 
allerdings das zuvor beschriebene »c.o.«, so können Sie auch diese von der 
Workbench starten! Hier nun auch noch ein Batch-File für die Besitzer eines 
Aztec-Compilers: 
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. key prg 
cc -t<prg>.c+l 
as <prg>.asm 
ln <prg>.o -lm -lc 

echo "Kompilier-, Assemblier- und Linkvorgang ist zu Ende" 

Für alle nachfolgenden Erklärungen möchten wir Sie bitten, alle Schritte direkt 
am Computer nachzuvollziehen, da es dann leichter für Sie wird. Zu Beginn 
müssen Sie natürlich den Computer starten. Falls Sie es nicht schon zuvor getan 
haben, müssen Sie das Preference-Programm starten und den CLI-Schalter auf 
»ON« setzen, da nur in diesem Fall CLI zu verwenden ist. Anschließend 
können Sie wieder Preference verlassen, am besten mit »Save«, da dann das 
CLI-Icon auch nach dem Einschalten des Computers erscheint. Nun starten Sie 
bitte CLI durch einen Doppelklick auf das CLI-Icon. Kurz darauf erscheint das 
CLI-Window. Ist es das einzige CLI-Window auf dem Bildschirm, so müßte das 
»l>«-Prompt darin erscheinen. Dahinter ist der Cursor zu erkennen. Nun 
können Sie sämtliche CLI-Befehle verwenden. Als Beispiel dafür tippen Sie 
bitte »dir« ein - mit anschließendem »RETURN«. Sie sehen nun das 
Inhaltsverzeichnis der Hauptdiskette. 

Nun wollen wir mit der Einführung in »C« beginnen. C ähnelt in vielen Punkten 
den Programmiersprachen Pascal und Modula, weshalb Pascal- und/oder 
Modula-Programmierer keine Schwierigkeit haben dürften, auf C umzusteigen. 

»C« wurde 1972 in den USA entwickelt, 1973/74 verbessert und anfangs vor¬ 
nehmlich unter dem Betriebssystem UNIX verwendet Da diese Sprache 
möglichst flexibel sein sollte, wurden ihr nur sehr wenige Befehle fest imple¬ 
mentiert. Darunter sind: 

- if -> Bedingte Anweisung 

- switch -> Bedingte Anweisungen 

- for, while -> Zähl- und bedingte Schleifen 

Es sind noch einige Befehle mehr vorhanden, auf die wir allerdings nicht ein- 
gehen werden, da sie nicht von größerer Bedeutung sind. Diese Befehle genügen 
jedoch, um alle programmkontrollierenden Funktionen durchführen zu können, 
zumal sich die meisten Befehle in Include-Dateien oder in Bibliotheken 
befinden, die der Sprache C zu ihrer Leistungsfähigkeit und Flexibilität 
verhelfen. 

Ein C-Programm setzt sich normalerweise aus drei Grundteilen zusammen. Im 
ersten Teil gibt der Programmierer an, welche Include-Dateien oder 
Bibliotheken er verwenden will, die somit beim Kompilieren eingelesen werden 
müssen. Im zweiten Teil werden die globalen Variablen deklariert. Auf diese 
Variablen kann von jeder Routine des Programms aus zugegriffen werden. Der 
dritte Teil besteht aus dem eigentlichen Progamm. Dieser Teil gliedert sich 
allerdings wieder in zwei Teile auf. Da ist zum einen der Teil mit den 
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Unterroutinen - in Pascal auch Procedures oder Functions genannt - und zum 
anderen der sogenannte »main«-Teil. Dieser Teil stellt die Hauptroutine des 
Programms dar, die beim Start des Programms aktiviert wird. Der Unterschied 
zu Pascal besteht darin, daß Unterroutinen und Hauptprogramm keine 
festgelegte Reihenfolge haben müssen. Es können in C also auch Unterroutinen 
aufgerufen werden, die erst später im Programm folgen. 

C-Programme wirken leider teilweise sehr undurchsichtig, was aber durch das 
Einfügen von Kommentaren und Unterroutinen wettgemacht wird. Solche 
Kommentare werden mit »/*« und »*/« geklammert. Aufpassen sollte man auf 
solche »Kleinigkeiten« wie Semikolons oder Kommata, da der Compiler 
oftmals solche Fehler nicht erkennt, sondern weiterkompiliert, was zum 
Absturz beim späteren Starten des Programms führen kann. Mit »C« zu 
arbeiten, heißt also korrekt und sauber arbeiten, sonst kann für nichts garantiert 
werden. 

Zusätzlich zu den oben genannten Befehlen besitzt »C« noch eine Reihe von 
Funktionen, von denen »printf« und »scanf« die wichtigsten sind, »printf« dient 
zur Ausgabe von Texten, Zahlen u.a. Mittels »scanf« können Texte und Zahlen 
eingelesen werden. 

Zu der Funktion »printf« wollen wir an dieser Stelle ein erstes Programm 
erstellen. Es soll nur den Text »Mein erstes C-Programm ausgeben«. Da Sie sich 
schon in CLI befinden, müssen Sie nur noch den Editor »ed« aktivieren. 
Zusätzlich muß noch der Name angegeben werden, den unser Programm haben 
soll, gefolgt von ».c«: 

1> ed test.c 

Nun befinden Sie sich im Editor. Da wir nur den Befehl »printf« verwenden 
wollen, der von »C« bereitgestellt wird, müssen wir keine Include-Dateien 
einiesen oder Variablen deklarieren. Also können wir gleich mit dem Programm 
beginnen. Das Programm besteht in unserem Fall nur aus der Hauptroutine, die 
mit »mainO« eingeleitet wird. Anschließend folgen die Anweisungen, die zur 
Hauptroutine gehören. Sie müssen mit den zwei geschweiften Klammem »{« 
und »)« geklammert werden. Zwischen diesen Klammem steht also das 
Hauptprogramm. In unserem Fall besteht es nur aus »printf("Mein erstes C- 
ProgrammXn");«. »printf« gibt, wie schon zuvor erwähnt, einen Text aus. Der 
Text steht anschließend in Klammem und von Hochkommata eingegrenzt. Ein 
Sonderfall ist noch mit eingebaut: »\n« bewirkt einen Zeilenvorschub, was nötig 
ist, da »printf« keinen automatischen Zeilenvorschub bewirkt. Neben »\n« gibt 
es unter anderem noch »\0«, was den ASCII-Code Null darstellt. Nun sieht 
unser Programm also folgendermaßen aus: 




20 Die Sprache »C« 


main () 

{ 

printfC'Mein erstes C-Programm\n") ; 

) 

Betätigen Sie nun die »ESC«-Taste und anschließend »X« und »RETURN«, um 
das Programm unter dem Namen »test.c« zu speichern. Um das Programm nun 
starten zu können, muß es zuerst mit dem Compiler in Maschinensprache 
übersetzt werden. Dies kann mit dem oben angegebenen Batch-File geschehen: 

1> EXECUTE comp test 

Nach einer Weile ist der Kompilier-Vorgang beendet, und es erscheint wieder 
das »l>«-Prompt. Nun kann das Programm mittels der Eingabe von »test« mit 
anschließendem »RETURN« gestartet werden. Das Ergebnis ist zwar nicht 
aufregend, aber es zeigt doch die Vorgehensweise beim Erstellen eines C- 
Programms. 

Nun wollen wir einen Schritt weitergehen, wir wollen weitere Funktionen 
verwenden, die sich in einer Include-Datei auf der Diskette befinden. Diese 
Funktionen sind »getchar« und »putchar«, die sich in der Datei »stdio.h« 
befinden. Zusätzlich deklarieren wir zwei Variablen. Die Variable »global« 
kann in allen Routinen verwendet werden, »lokal« kann nur in der Hauptroutine 
verwendet werden. Wäre eine weitere Routine vorhanden, so könnten in ihr nur 
die Variable »global« sowie ihre eigenen lokalen Variablen verwendet werden. 

»getchar« und »putchar« haben im Prinzip die gleiche Funktion wie »scanf« und 
»printf«, sind jedoch für einzelne Zeichen ausgelegt. 

Um das Programm erstellen zu können, müssen Sie als erstes in den Editor mit 
»ed test2.c«. Das Programm sieht dann folgendermaßen aus: 


#include <stdio.h> 

char global; 

main () 

{ 

char lokal; 
lokal = getchar (); 
global = lokal; 
putchar(global); 

} 

Auch dieses Programm muß nach dem Speichern kompiliert werden. Dies 
geschieht mit »EXECUTE comp test2«. 

An dieser Stelle wollen wir auf die möglichen Datentypen eingehen, mit denen 
Variablen deklariert werden können: 
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Datentyp 


Wertebereich 



Speicherlänge 

int 

- 

-32768 


bis 

32767 

_ 

2 

BYTE 

long int 

- 

-2*10 hoch 9 

bis 

2*10 hoch 9 

- 

4 

BYTE 

unsigned int 


0 


bis 

65535 

- 

2 

BYTE 

char 


0 


bis 

255 (ASCII) 

- 

1 

BYTE 

FLOAT 

- 

*10 hoch 

-37 

bis 

±10 hoch 38 

- 

4 

BYTE 

DOUBLE 


*10 hoch 

-307 

bis 

±10 hoch 308 

- 

8 

BYTE 

/UBYTE 

- 

0 


bis 

255 

- 

1 

BYTE 

/UW0RD 

- 

0 


bis 

65535 

- 

2 

BYTE 

/ULONG 

- 

0 


bis 

4.3*10 hoch 9 

- 

4 

BYTE 

BYTE 

- 

-128 


bis 

127 

- 

1 

BYTE 

WORD 

- 

-32768 


bis 

32767 

- 

2 

BYTE 

LONG 


-2,15*10 

hoch 9 

bis 

2,15*10 hoch 9 

- 

4 

BYTE 


Nun wollen wir noch ein Programm schreiben, das Unterroutinen verwendet. 
Solchen Routinen können Parameter übergeben werden, sie können aber auch 
Werte zurückgeben. Hier das Programm: 

ttinclude <stdio.h> 

char eingabe; 

routine(wert) 
char wert; 

{ 

putchar(wert); 
eingabe = getcharO; 
return(eingabe); 

) 

main() 

( 

eingabe = getcharO; 
eingabe = routine(ei 
putchar(eingabe) ; 

) 

Nun wissen Sie über die Struktur von C-Programmen Bescheid. In den 
nachfolgenden Teilen gehen wir näher auf die Programmierung ein. 


/* Routinenkopf mit Parameter */ 
/* Datentyp des Parameters */ 


/* Hauptroutine */ 


ngabe); /* Routine aufrufen */ 
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1.1 Datentyp-Umwandlungen 

C bietet die Möglichkeit, Daten innerhalb des Programms auf einfache 
Weise in andere Datentypen umzuwandeln. Dazu braucht nur vor den 
umzuwandelnden Wert bzw. vor die Variable in runden Klammern der 
Datentyp gesetzt zu werden, in den umgewandelt werden soll. Wenn 
beispielsweise eine Integerzahl in einer Integervariablen gespeichert ist, aber 
einer FLOAT-Variablen zugewiesen werden soll, sd geschieht das folgen¬ 
dermaßen: 

floatvar = (FLOAT) intvar; 

Dies gilt auch für Structures, die später erläutert werden. Als Besonderheit 
gilt an dieser Stelle, daß in solchen Fällen das Wort »struct« noch davor¬ 
gesetzt werden muß. Beispiel: 

struct testl /* erste Structure deklarieren */ 

{ 

FLOAT float; 
lnt lnt; 

); 

struct test2 /* zweite Structure deklarieren */ 

{ 

FLOAT float; 
lnt lnt; 

); 


maln() 

{ 

struct testl varl; /* Variablen vom Typ testl */ 
struct test2 var2; /* und test2 deklarieren */ 


var2 = (struct test2) varl; /* Zuwelsen und umwandeln, */ 

. /* da nicht vom gleichen Typ */ 
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1.2 Zeiger 

Ein sehr wichtiges Thema sind die Zeiger. Sie gibt es zwar auch in Pascal und 
Modula, doch ist ihre Verwendung in C besonders flexibel. 

Ein Zeiger, auch Pointer oder Ptr genannt, ist eine Adreßvariable. Die 
Adresse, die sie enthält, ist das erste Byte einer Variablen. Man sagt auch, 
der Zeiger zeigt auf die Variable. 

Deklarieren kann man einen Zeiger folgendermaßen: 

FLOAT »fit; 

Wir haben also einen Zeiger auf eine Float-Variable deklariert. Durch den 
Stern »»« wird »fit« zum Zeiger. Es muß aber beachtet werden, daß durch 
diese Deklaration nur Speicherplatz für den Zeiger, nicht aber für die 
Variable bereitgestellt wird. 

Zu den Zeigern gehört auch der Adreßoperator »&«. Er ermittelt die 
Adresse einer Variablen. Das bedeutet, wenn man einen Zeiger auf eine 
bestimmte Variable setzen will, so geht man folgendermaßen vor: 

FLOAT »fit; /» Zeiger deklarieren »/ 

FLOAT var; /» Variable deklarieren */ 

fit = &var; /» Zeiger auf Variable setzen */ 

Durch den Adreßoperator kann man also die Adresse einer Variablen 
ermitteln. Umgekehrt kann durch den Stern »*« auf den Speicherbereich 
zugegriffen werden, auf den »fit zeigt: 

FLOAT »fit; /* Zeiger deklarieren */ 

FLOAT var; /* Variable deklarieren »/ 

»fit * var; /» Varlablenvert ln Bereich kopieren, 
auf fit zeigen */ 
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1.3 Bedingungen 

In der Sprache C sind verschiedene Möglichkeiten vorhanden, zu testen, ob 
eine Bedingung wahr oder falsch ist. 

Die erste Möglichkeit ist die Verwendung des »if«-Befehls. Er hat folgende 
Syntax: 

if(BEDINGUNG) 

DANN; 

eise 

ANSONSTEN; 

Alle kleingeschriebenen Wörter sind in dieser Form anzugeben. Auf den 
»else«-Zweig kann verzichtet werden. »DANN« gibt den Befehl bzw. die 
Befehle an, die ausgeführt werden sollen, wenn die Bedingung wahr ist. 
Wenn nur ein Befehl ausgeführt werden soll, so wird dieser normal ange¬ 
geben: 

lf(x =■* y) 

printf(”x Ist gleich y”); 

Sollen mehrere Befehle ausgeführt werden, so müssen diese geklammert 
werden: 

if(x - y) 

{ 

printf(”x ist gleich y,\n"); 
prlntf("also ist y auch gleich x"); 

}; 

Das gleiche gilt auch für den »else«-Zweig. 

Die Bedingung besteht immer aus dem Vergleich zweier Werte miteinander. 
Folgende Vergleichsoperatoren stehen zur Verfügung: 


> 

- 

Größer als 

> = 

- 

Größer als oder gleich 

< 

- 

Kleiner als 

< = 

- 

Kleiner als oder gleich 

= = 

- 

Gleich 

! = 

- 

Nicht Gleich 


Wenn x gleich 4 und y gleich 7 ist, dann ist also die Bedingung (x ! = y) wahr, 
da x ungleich y ist. 
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Eine weitere Möglichkeit, einen Programmteil nur unter bestimmten Bedin¬ 
gungen ablaufen zu lassen, stellt der Befehl »switch« dar. Er hat folgende 
Syntax: 

svltch(AUSDR) 

{ 

case AUSDR1 : DANN; 
case AUSDR2 : DANN; 


usv. 

}; 

AUSDR ist ein Wert, der mit den Ausdrücken nach den »case«-Marken 
verglichen wird. Sind dann beide Werte gleich, so wird der Befehl bzw. wer¬ 
den die Befehle nach dem Doppelpunkt ausgeführt. 
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1.4 Schleifen 

Wiederholungen innerhalb eines Programms nennt man Schleifen. C kennt 
verschiedene Arten von Schleifen. Der erste Typ ist die Zählschleife: 

for(INIT; BED; INC) 

BEFEHLE; 

Bei INIT muß die Schleifenvariable, die für die Zählschleife benötigt wird, 
auf den Anfangswert gesetzt werden. Diese Schleifenvariable muß von einem 
ganzzahligen Typ sein. 

BED stellt die Abbruchbedingung der Schleife dar. Wenn diese Bedingung 
nicht mehr erfüllt ist, wird die Schleife abgebrochen. Welche Bedingungen 
möglich sind, können Sie aus Kapitel 1.3 ersehen. 

Da die Schleifenvariable nicht automatisch erhöht oder erniedrigt wird, müs¬ 
sen Sie selbst diese Aufgabe übernehmen. Dies geschieht bei INC. 

Als Beispiel führen wir nun eine Zählschleife an, die von 0 bis 1000 zählt: 

int zaehler; 

fortzaehler = 0; zaehler <= 1000; zaehler++) 
prlntf(”\n*d",zaehler); 

»zaehler + +« hat die gleiche Bedeutung wie »zaehler = zaehler +1«. 

Eine weitere Möglichkeit, Schleifen zu bilden, ist die While-Schleife. Sie wird 
solange durchlaufen, bis die Bedingung nicht mehr gilt. Ihre Syntax: 

vhile(BEDINGUNG) 

BEFEHL; 

Die Bedingung entspricht der der If-Anweisung. 

Ähnlich wie die While-Schleife funktioniert die »do..while«-Schleife. Die 
Besonderheit liegt darin, daß das Abbruchkriterium erst nach einmaligem 
Durchlaufen der Befehle innerhalb der Schleife geprüft wird: 

do 

BEFEHL; 

vhlle(BEDINGUNG); 

Auch in diesem Fall müssen die Befehle innerhalb der Schleife geklammert 
werden, wenn die Schleife aus mehr als einem Befehl besteht. 
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1.5 Strukturen 

Von grundlegender Bedeutung sind die Strukturen, auch Structures oder Listen 
genannt. In ihnen können verschiedene Variablen unter einem Oberbegriff 
zusammengefaßt werden. Eine Structure, wie wir sie nachfolgend nennen 
wollen, wird von dem Wort »struct« eingeleitet. Ihm folgt der Name, den die 
Structure haben soll, gefolgt von den Einträgen, die in der Structure 
zusammengefaßt werden sollen. Solche Einträge können auch weitere Structures 
sein. Ein Beispiel: 

struct Bsp 
t 

FLOAT fit; 

int i; 

struct Test demostruct; 
struct Bsp *ptr; 

1; 

Die Structure Bsp besteht also aus den Einträgen fit, i, demostruct und dem 
Zeiger ptr, der auf eine weitere Structure vom Typ Bsp zeigt. 

Bsp stellt nun einen neuen Datentyp dar. Um ihn verwenden zu können, muß 
eine Variable von diesem Typ deklariert werden. Dies geschieht folgender¬ 
maßen: 

struct Bsp beispiel; 

Will man nun auf die einzelnen Einträge zugreifen, so geschieht das folgen¬ 
dermaßen: 

Auf fit, i und demostruct kann sehr einfach zugegriffen werden: 

beispiel.fit = 2.45; 
beispiel.i = 3; 

also einfach durch einen Punkt zwischen dem Variablennamen und dem Eintrag, 
auf den zugegriffen werden soll. 

Um auf die Float-Zahl der Structure zugreifen zu können, auf die ptr zeigt, muß 
ein »Pfeil« zwischengesetzt werden. Dieser »Pfeil« ist eigentlich nur eine 
Abkürzung für die ausführliche Schreibweise »(*beispiel.ptr).flt«: 

beispiel.ptr->flt = ....; 


Man muß nicht unbedingt eine Variable vom diesem Structuretyp deklarieren. 
Es kann auch ein Zeiger darauf verwendet werden, für den die gleichen 
Bedingungen gelten wie für die Zeiger in Kapitel 1.2. Ein solcher Zeiger wird 
folgendermaßen deklariert: 


struct Bsp »beispiel; 
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Nun noch einige allgemeine Anmerkungen zu diesem Buch: 

Beim Erstellen der Programme sind wir von der Lattice C Version ausge¬ 
gangen. Zur korrekten Einstellung des Screens haben wir ein kleines C - 
Programm geschrieben, das ein Test-Bild in einer Auflösung von 640 x 512 
Pixels erzeugt. Dieses Bild muß den gesamten Bildschirm ausfüllen. Die 
Regler für die Vertikal bzw. Horizontalablenkung finden Sie am hinteren 
Teil des Monitors. 

Das »Testbild«-Programm öffnet einen Screen mit einer Auflösung von 640 x 
512 Pixels. Anschließend wird je eine rote, grüne und blaue Box in die obere 
Hälfte, sowie eine schwarze Box mit einem weißem Gitter in die untere 
Hälfte des Screens gezeichnet. Nachdem der Monitor optimal eingestellt ist, 
kehrt man durch das Drücken der Taste »RETURN« in das CLI zurück. 
Dieses Programm sollte nur vom CLI aus gestartet werden, da es beim Star¬ 
ten von der Workbench aus nicht beendet werden kann. Das gleiche gilt auch 
für einige weitere Demonstrationen, wie zum Beispiel für die »Dosdemo«. 
Das solche Programme nicht von der Workbench aus gestartet werden kön¬ 
nen, liegt daran, daß die DOS-Befehle, sowie »scanf« und »printf« nur auf 
ein CLI-Fenster reagieren. Das heißt, die Programme können zwar schon 
von der Workbench aus gestartet werden, aber sie führen die oben genann¬ 
ten Befehle nicht richtig aus. 
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1.6 Die Bibliotheken 


Die Hardware des Amiga ist von einer Vielzahl von leistungsstarken Soft¬ 
ware-Modulen umgeben. Durch diesen modularen Aufbau bieten sich 
ungeahnte Möglichkeiten. Das System wird somit flexibler und leistungs¬ 
stärker. Module können hinzugefügt oder, falls notwendig, verändert werden. 

Einen Teil dieser Amiga-System-Software-Module bilden die Libraries, zu 
deutsch (Software-)Bibliotheken. Das Amiga-System enthält bisher 16 
Module. Hier eine Übersicht: 


clist.lib 


console.lib 


diskfont.lib 


dos.üb 


exec.lib 


graphic.lib 


Enthält einige nützliche Routinen, die den Um¬ 
gang und die Anwendung der Copper-Liste ver¬ 
einfachen. 

Dieses Library enthält Programme für den Um¬ 
gang mit der Tastatur, der sogenannten Console. 

Das diskfont.lib ermöglicht die Verwendung der 
verschiedenen Schrifttypen,die sich auf der Work- 
bench-Diskette befinden. 

Durch dieses Library wird dem Amiga unter 
anderem der Zugriff auf die Diskette ermöglicht. 
Der Zugriff auf die Diskette ist dank dieses Libra¬ 
ries fast so einfach, wie von der Benutzerschnitt¬ 
stelle CLI aus. 

Dieses Library bildet den System-Kern des Amiga. 
Dieser Kern entscheidet z.B. welche Tasks zum 
Laufen kommen (in der Computersprache 
bezeichnet man dies mit Scheduling) oder wieviel 
Speicherplatz für ein Programm bereitgestellt wer¬ 
den muß. 

Ohne Grafik geht heutzutage nichts mehr. Das 
graphic.lib ist ein sehr leistungsstarkes und 
umfangreiches Bibliotheksmodul, dessen Funktio¬ 
nen unter anderem durch den direkten Zugriff auf 
den Blitter und Copper phantastische Geschwindig¬ 
keiten in punkto Grafik sowie Animation ermög¬ 
lichen. 
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icon.lib 


info.lib 


intuition.lib 


janus.lib 


layers.lib 


mathffp.lib 


mathieeedoubbas.lib 


mathtrans.lib 


Hier sind verschiedene, durchaus nützliche Utilities 
für den Umgang mit den, von der Workbench her 
bekannten Icons enthalten. Es ist ebenfalls eines 
der wenigen Libraries, die sich auf der Workbench- 
Disk befinden. 

Dieses Library wird dazu verwendet um Infor¬ 
mation über Dateien, Datei-Verzeichnisse oder 
ganze Disketten zu bekommen. Es wird kaum ver¬ 
wendet und befindet sich auf der Workbench-Dis- 
kette. 

Das Intuition.lib ist eines der wichtigsten Libraries 
des Amiga. Ohne dieses Library wäre keine Bedie¬ 
nung mit der Maus oder die einfache Handhabung 
von Menüs denkbar. 

Dies ist bisher das letzte Bibliotheks-Modul, das 
dem Amiga beigefügt wurde. Es befindet sich 
ebenfalls auf der Diskette und wird zur Steuerung 
der Side-Car Hardware benötigt. 

In diesem Bibliotheks-Modul sind Routinen ent¬ 
halten, die dem Anwender beispielsweise das 
Handling von überlappenden Display-Elementen 
erleichtern. 

Mit diesem sogenannten FFP-Basic-Mathematik- 
Library können einfache mathematische Aufgaben, 
wie z.B. die Multiplikation oder Division, gelöst 
werden. 

Dies ist das erweiterte FFP-Basic-Mathematik- 
Library. Es befindet sich auf der Workbench-Dis- 
kette und enthält eine Vielzahl von mathe¬ 
matischen Funktionen, die Zahlen im IEEE-Stan- 
dard mit doppelter Genauigkeit verarbeiten. 

Für schwierigere mathematische Aufgaben, wo 
Funktionen wie arcsin, arccos u.s.w Verwendung 
finden, enthält dieses Bibliotheks-Modul genügend 
Befehle. Da diese Funktionen nicht ständig ver¬ 
wendet werden, ist dieses Library auf der Work- 
bench-Disk enthalten. 
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timer.lib Wenn Sie zeitlich im Bilde sein wollen, bietet sich 

die Verwendung dieses Libraries an. Leider kann 
beim Amiga 1000 nur die Software-Uhr ange¬ 
sprochen werden. Bei den Versionen 500 und 2000 
ist diese Uhr jedoch batteriegepuffert. 

translator.lib Das translator.lib hat die Aufgabe Sätze, die in 

englisch verfaßt sind, für die Sprachausgabe vor¬ 
zubereiten. Es findet kaum Verwendung und ist 
deshalb auf der Systemdisk enthalten. 

Je nach Art des Programms, das der Programmierer entwickeln will, muß er 
selbständig entscheiden, welche Bibliotheks-Module er benötigt. Sicherlich 
werden Sie nun denken, je mehr Libraries verwendet werden, desto besser 
wird das Programm. Im Gegenteil! Für sehr gute Programme reichen schon 
2 bis 3 Libraries aus. 

Beim Umgang mit den Libraries müssen bestimmte Regeln eingehalten wer¬ 
den, damit die jeweiligen Funktionen ansprechbar sind. So hat es z.B. keinen 
Zweck, Funktionen eines Libraries aufzurufen, wenn das jeweilige Library 
nicht geöffnet wurde. 

Bevor jedoch das jeweilige Library geöffnet wird, muß der »Basis« des Libra¬ 
ries ein Zeiger zugewiesen werden, hier am Beispiel des Intuition Library 
demonstriert, der von OpenLibrary zurückgegeben wird: 

IntultlonBase - (struct IntultlonBase *) 

Openlibrary("Intuition.llbrary”, 0); 

Anschließend enthält IntuitionBase die Einsprungadresse der Intuition- 
Library. Enthält diese Variable den Wert »NULL«, war es nicht möglich, das 
Library zu öffnen. 

Ist der Wert ungleich »NULL«, verlief alles normal und das Library konnte 
geöffnet werden. 

Nachdem Sie ein Library geöffnet haben, muß es natürlich auch wieder 
geschlossen werden: 

CloseLibrary(IntultlonBase); 
schließt das jeweilige Library. 
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Hier zum besseren Verständnis nochmals ein Beispiel: 

/» Öffnen und Schließen eines Blbllotheksmodules «/ 


struct GfxBase »GfxBase: /* Zeiger für die Einsprungadresse */ 

. /* deklarieren */ 


maln() 

{ 

GfxBase « (struct GfxBase *) 

OpenLlbraryC’graphlcs.llbrary", 0); /* Library öffnen */ 
lf (GfxBase == NULL) 

{ 

prlntf("öffnen des graphlcs.llbrary nicht möglich t\n”); 
exlt(FALSE); 

) 


/* 

Hier das Jeweilige Programm eintragen 

*/ 

/* Zum Schluß Blbliotheks-Module schließen */ 

CloseLlbrary(GfxBase); 

) 

IntuitionBase und GfxBase dürfen mit struct IntuitionBase *IntuitionBase; 
bzw. struct GfxBase *GfxBase; deklariert werden, da sie die Einsprungadres¬ 
sen der Intuition- und der Graphics-Library darstellen. Für alle anderen 
Libraries gilt folgende Deklaration: 
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Beispiel Diskfont-Library 


ULONG DlskfontBase; 


main() 

{ 

DlskfontBase = OpenLlbrary("diskfont.llbrary",0); 
lf (DlskfontBase ** NULL) 

{ 

prlntf("Öffnen des dlskfont.llbrary nicht möglich !\n”); 
exlt(FALSE); 

} 


/* 

•/ 


Hier das jeweilige Programm eintragen 


/* Zum Schlup Bibllotheks-Module schließen */ 

CloseLlbrary(DlskfontBase ); 

} 
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1.7 Die Devices 

Neben den Libraries, die für den Programmierer Erleichterungen und für 
das System eine große Flexibilität darstellen, steht dem Programmierer 
weiteres großes Hilfsmittel zur Verfügung: die Devices. 

Devices, zu deutsch Vorrichtungen, sind die Bindeglieder zwischen der 
(externen) Hardware und der Software des Amiga. Durch sie können Daten 
zur Hardware gesendet oder von ihr empfangen werden. Somit ist, z.B. durch 
das Verändern von Parametern der Trackdisk-Device, das Lesen von frem¬ 
den Diskettenformaten, wie IBM oder Apple-Format möglich. 

Der Amiga enthält 17 verschiedene Devices, die sich um die Vorrichtungen, 
wie Tastatur, der seriellen und parallelen Schnittstellen und einiges mehr 
kümmern. Nicht alle werden ständig benötigt, sondern befinden sich im 
»Devs«-Directory auf der Workbench-Disk. 

Die Devices des Amiga im Überblick: 

audio.device Mit ihr wird der »Sound« des Amiga gesteuert. Je 

nach Belieben richtet sie die 4 Audio-Kanäle des 
Amiga ein, bestimmt die Amplitude des Tons und 
vieles mehr. 

bootblock.device Testet, ob es sich um eine Kickstart- oder um eine 

DOS-Diskette handelt. Bei den neuen Amigas ist 
diese Vorrichtung weggefallen, da bei ihnen keine 
Kickstartdiskette mehr erforderlich ist. 

clipboard.device Wird benötigt, um Daten zwischen zwei Anwen¬ 

dungen zu transferieren. Da dies nicht häufig vor¬ 
kommt, befindet sich diese Device auf der Work- 
bench-Disk. 

console.device Regelt die Ein- und Ausgabe des Systems über die 

Tastatur und den Bildschirm. 

gameport.device Gameport.device übernimmt die Steuerung der 

Ein- und Ausgabe über die GamePorts 1 und 2. 

input.device Diese Device regelt die gesamte Ein- und Ausgabe 

des Amiga. Es ist eine Kombination aus timer-, 
gameport- und keyboard.device. 

inputevent.device Inputevent.device erfaßt die Ereigniseingaben, wie 

z.B. Gadgets. 
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jdisk.device 


keyboard.device 


keymap.device 


Dies ist die neuste Device des Amiga. Sie über¬ 
nimmt die Steuerung der Harddisk des Amiga, die 
sich auf der IBM-PC kompatiblen Seite des 
Amiga2000 oder im SideCar befindet. Da sie sehr 
neu ist, befindet sie sich ebenfalls auf der Work- 
bench-Disk. 

Hiermit wird der Zugriff auf die Tastatur des 
Amiga gesteuert. 

Damit kann die Belegung der Tastatur verändert 
werden. 


narrator.device 


parallel.device 


printer.device 


Narrator.device ist für die Steuerung der Sprach- 
ausgabe notwendig. Da sie nicht ständig benötigt 
wird, befindet sie sich auf der Workbench-Disk. 

Hiermit kann der Parallelport gesteuert werden. 
Diese Device befindet sich ebenfalls auf der Work- 
bench-disk. 

Diese Device dient zur Kommando-Steuerung des 
Druckers, um z.B. einen Wagenvorlauf des Druk- 
kers zu bewirken. Printer.device befindet sich 
ebenfalls auf der Workbench-Disk. 


prtbase.device 


serial.device 


timer.device 


trackdisk.device 


Prtbase.device übernimmt die Datendefinition der 
printer.device. 

Diese dient zur Deklaration des seriellen Ports des 
Amiga. Sie befindet sich ebenfalls auf der Work¬ 
bench-Disk. 

Mittels Timer.device kann auf die Systemzeit zuge¬ 
griffen werden. 

Diese Device kontrolliert die Floppies des Amiga. 
Sie übernimmt Funktionen, wie das Lesen und 
Schreiben von Daten und einiges mehr. 


Um mit einer Devices arbeiten zu können, muß sie geöffnet werden. Dies 
geschieht mit 


printerPort » CreatePort(”printer.port”,0); 


wobei printerPort zurückgegeben wird. 

Danach muß die Device geöffnet werden, in diesem Fall "printer.device": 
fehler » OpenDevlce("prlnter.device",0,Srequest,0); 
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Wenn Fehler gleich ungleich 0 ist, konnte die Device nicht geöffnet werden. 
&request ist der Pointer auf eine Structure der jeweiligen Device, die 
bestimmte »Routinen« wie z.B. das Drucken eines Screens enthalten oder 
auf die allgemeine Ein/Ausgabe-Structure von EXEC. 

Nachdem die Device und der Port geöffnet sind, kann die benötigte Ein- und 
Ausgabe-Structure initialisiert werden. 

Nach der Initialisierung wird die jeweilige »Funktion«, wie z.B. das Drucken 
eines Textes, mit 

DoIO(&request); 

gestartet. 

&request ist der Pointer auf die Ein- und Ausgabe-Structure der jeweiligen 
»Funktion«. 

Nachdem die Ein- und Ausgabe beendet ist, muß der Port und die Device 
wieder geschlossen werden. Dies kann mit 

DeletePort(printerPort); 

CloseDevice(&prefrequest); 

erledigt werden. 

1 /******************************* 

2 

3 Testbild 

4 last update 26/05/87 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt & Technik 1987 

7 

8 ******************************* 

9 

10 Dieses Programm erzeugt ein Testbild, mit dem der Monitor au-f die idealen 

11 Werte eingestellt werden kann. 

12 

13 ******************************/ 

14 

15 #include <exec/types.h> /* Include-Files einladen */ 

16 #include <intuition/intuition.h> 

17 

18 struct IntuitionBase * IntuitionBase; 

19 struct G-fxBase *GfxBase; 

20 

21 struct NewScreen ns = /% Screen de-finieren */ 

22 { 

23 0, 

24 0, 

25 640, 

26 512, 

27 4, 

28 0,1, 

29 HIRESILACE, 

30 QJSTOMSCREEN, 

31 NULL, 
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32 NULL, 

33 NULL, 

34 NULL, 

35 >; 

36 

37 main() 

38 ( 

39 LÜNG zahl; 

40 char taste; 

41 struct Screen *screen; 

42 

43 IntuitionBase = (struct IntuitionBase *) /* Intuition oe-f-fnen */ 

44 OpenLibrary("intuition.library",0); 

45 i-f (IntuitionBase — NULL) exit(FALSt); 

46 

47 G-fxBase = (struct GfxBase *) /* Graphics oe-f-fnen */ 

48 OpenLibrary("graphics.library",0); 

49 i-f (G-fxBase = NULL) exit(FALSE); 

50 

51 i-f ((screen=( struct Screen* ) /* Screen oe-f fnen */ 

52 OpenScreen(&ns)) — NULL) exit(FALSE); 

53 

54 SetRGB4(&screen->ViewPort,0,0,0,0); /* Farben setzen */ 

55 SetRGB4(&screen->ViewPort,1,15,15,15); 

56 SetRGB4(&screen->ViewPort,2,15,0,0); 

57 SetRGB4(&screen->ViewPort,3,0,15,0); 

58 SetRGB4(&screen->ViewPort,4,0,0,15); 

59 

60 SetAPen(&screen->RastPort,1); /* 1. Farb-Quadrat #/ 

61 SetDrMd(&screen->RastPort,JAM1); 

62 RectFil1(&screen->RastPort,0,0,639,511); 

63 

64 SetAPen(&screen->RastPort,2); /* 2. Farb-Qjadrat */ 

65 RectFil1(&screen->RastPort,0,0,211,256); 

66 

67 SetAPen(&screen->RastPort,3); /* 3. Farb-Qjadrat */ 

68 RectFil1(&screen->RastPort,2l4,0,427,256); 

69 

70 SetAPen(&screen->RastPort,4); 

71 RectFil1(&screen->RastPort,429,0,639,256); /* 4. Farb-Qjadrat #/ 

72 

73 SetAPen(&screen->RastPort,0); 

74 RectFil1(&screen->RastPort,170,284,470,484); /* 5. Farb-Gkiadrat */ 

75 

76 SetAPen(&screen->RastPort,1); 

77 

78 -for(zahl =284; zahl<484; zahl = zahl + 20) 

79 < 

80 Move(&screen->RastPort, 170, zahl); /* Schaerfe - Gitter Zeichen */ 

81 Draw(&screen->RastPort, 470, zahl); 

B2 > 

83 

84 -for (zahl = 170; zahl<470; zahl = zahl + 20) 

85 ( 

86 Move(&screen->RastPort, zahl, 284); 

87 Draw(&screen->RastPort, zahl, 484); 

88 > 

89 

90 scan-f("Xc", &taste); /* wenn RETURN, dann zurueck */ 

91 

92 CloseScreen(screen); 

93 CloseLibrary( IntuitionBase); 

94 CloseLibrary(G-fxBase); 

95 > 


/* Screen und Libs schllessen */ 
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2 


Der Screen 


Zunächst, bevor wir mit dem Umgang der Screens beginnen können, müssen 
wir festlegen was überhaupt ein Screen ist, was er benötigt und aus welchen 
»Bauteilen« er besteht. 

Nun, was sind Screens? Man könnte Screens als die Grundlage aller Dar¬ 
stellungsformen von Intuition bezeichnen. Ein Screen ist also einer von vielen 
möglichen virtuellen Bildschirmen, auf dem verschiedene Fenster, so¬ 
genannte Windows, geöffnet werden können. 

Diese Screens können beim AMIGA verschiedene Auflösungen und Farb¬ 
tiefen annehmen. Horizontal gibt es die Möglichkeit einen Screen mit 640 
oder 320 Pixels darzustellen. Dank des PAL-AMIGA ist die vertikale Auf¬ 
lösung, im Vergleich zu AMIGA’s Anfangszeiten, etwas erhöht worden, sie 
beträgt nun 256 ohne und 512 Pixels mit Zeilensprungverfahren. Zeilen¬ 
sprungverfahren bedeutet, daß sich der Screen aus zwei zusammen¬ 
geschobenen Halbbildern zusammensetzt. Die Folge ist, daß die Bild¬ 
frequenz nun nur noch 25 Hz beträgt, weshalb die Darstellung leicht flackert. 
Es können auch mehrere Screens gleichzeitig in verschiedenen Auflösungen 
geöffnet werden. Merken sollte man sich nur: wenn einmal Interlace (Zeilen¬ 
sprungverfahren) eingeschaltet ist, so flackern auch die anderen geöffneten 
Screens im Hintergrund, auch dann, wenn sie keinen Interlace-Modus ver¬ 
wenden. 

Der Anzahl der Screens ist keine bekannte softwaremäßige Grenze gesetzt. 
Das einzige Hemmnis, das wir gefunden haben, ist der begrenzte Speicher¬ 
platz, denn die Video-Hardware des Amiga kann nur die untersten 512 
KByte für den Aufbau von Screens ansprechen. Dieser Speicherbereich wird 
auch CHIP-Memory genannt, da die Chips nur auf diesen Bereich zugreifen 
können. Der darüberliegende Speicherbereich heißt FAST-Memory, da die 
CPU beim Zugriff auf diesen Bereich nicht von den Custom-Chips gebremst 
wird. 
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Viel Speicherplatz wird auch dann benötigt, wenn viele Farben in einem 
Screen und somit viele Bit-Planes dargestellt werden sollen. Der Amiga bie¬ 
tet in punkto Farben eine sehr breite Palette an. Drei »Farbregler«, je einen 
für rot, grün und blau, ermöglichen 16 mal 16 mal 16 gleich 4096 Farben. 
Diese maximale Anzahl von Farben ist aber leider nur in einem besonderen 
Modus, dem HAM-Modus (Hold-And-Modify, zu deutsch »halte und verän¬ 
dere«) bei einer Screenauflösung von 320 mal 256 Pixels gleichzeitig darstell¬ 
bar. Hierbei wird mit einer Bit-Plane-Tiefe von 6 gearbeitet. Tiefe 5 und 6 
werden dazu benötigt, um die Tiefen von 1 bis 4 zu verändern. Im HAM- 
Modus benötigt der Amiga rund 48 KByte für den Screen. Dies berechnet 
sich aus der Auflösung 320 mal 256 Pixels mal der Bit-Plane-Tiefe 6, geteilt 
durch 8, da 8 Bit ein Byte sind. 

Leider kann auch nicht in jedem Darstellungsmodus die maximale Anzahl 
von 6 Bitplanes, bzw. Bit-Tiefen, dargestellt werden. Dazu siehe Tabelle 
Nr. 1. 


Auflösung max. Bit-Tiefe Farben benot. Speicherplatz 


320 x 256 

5 

32 

51 200 Byte 

320 x 512 

5 

32 

102 400 Byte 

640 x 256 

4 

16 

81 920 Byte 

640 x 512 

Besondere Modi: 

4 

16 

163 840 Byte 

Extra-Halfbright: 

320 x 256 

6 

64 

61 440 Byte 

320 x 512 

6 

64 

122 880 Byte 

HAM:320 x 256 

6 

4096 

61 440 Byte 


Tabelle Nr. 1 


Sicherlich wird nun bei einigen Lesern die Frage auftauchen, was ein Screen, 
neben viel Speicherplatz, noch so alles benötigt. Nun da wäre zunächst eine 
Liste, die die Verwaltung des Speicherplatzes und somit die Definition des 
Screens übernimmt. Diese Liste wird als ViewPort-Liste bezeichnet. Von ihr 
können weitere Informationen über die Farbtabelle der verwendeten Farben, 
sowie über die Größe und Lage der Bit-Maps und der Copper-Liste, die zur 
Steuerung der Video-Hardware benötigt wird, abgeleitet werden. Eng ver¬ 
wandt mit der ViewPort-Liste ist die RastPort-Liste. Diese Liste definiert 
einen Ausschnitt des Screens, somit also ein Window. Es kann natürlich auch 
Vorkommen, daß dieser Ausschnitt den ganzen Screen umfaßt. 
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Mindow 


>|ViewPort 


View 


Sei* een 


Rasinfo 


Bi tM^p 


RastPort 


Bild 2.1 Zeigt den Zusammenhang zwischen Window, Screen, Rast- und ViewPort 


Damit dem Anwender der Umgang mit Rast- und ViewPort, sowie dem 
Bereitstellen von Speicherplatz nicht so schwer fällt, stellt Intuition nützliche 
Hilfsmittel zur Verfügung. Die Screens, die mit diesen Hilfsmitteln erstellt 
werden, bezeichnet man als Custom-Screens. Bevor jedoch das Bemalen 
eines solchen Screens losgehen kann, muß der Anwender Intuition mit einer 
NewScreen-Structure die gewünschten Daten des Screens mitteilen. Aus 
diesen Daten und ein paar anderen Befehlen erstellt dann Intuition die 
benötigten Listen, ohne daß der Programmierer sich noch darum zu küm¬ 
mern braucht. 

Die NewScreen-Structure hat folgenden Aufbau: 

struct NevScreen 
{ 

SHORT LeftEdge, TopEdge; 

SHORT Uldth, Helght, Depth; 

UBYTE DetailPen, BlockPen; 

USHORT VlevModes; 

USHORT Type; 

struct TextAttr "Fonts; 

UBYTE »DefaultTitle; 
struct Gadget »Gadgets; 
struct BitMap "CustomBitMap; 

): 


Da die Structure-Namen von Commodore festgelegt sind und in ihrer Form 
fest in der Sprache C auf dem AMIGA implementiert sind, müssen wir die 
englischen Namen übernehmen.Die einzelnen Variablen haben folgende 
Bedeutung: 

LeftEdge X-Position des Screens (noch nicht verwendbar). 
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TopEdge 

Width 

Height 

Depth 

DetailPen 

BlockPen 

ViewModes 


Y-Position des Screens nach dem Öffnen. 
Die Breite des Screens. 


Die Höhe des Screens. 

Anzahl der Bit-Planes (Farbanzahl = 2 ~ Depth). 

Hier muß die Farbregister-Nummer eingetragen werden, mit 
dessen Farbe z.B. der Text in der Titel-Zeile geschrieben 
werden soll. 

Hier muß die Farbregister-Nummer eingetragen werden, mit 
dessen Farbe beispielsweise der Titel-Balken des Screens 
gezeichnet werden soll. 

Der Amiga hat eine Vielzahl von Grafikauflösungen, die 
durch »ViewModes« bestimmt werden können: 


DUALPF 

HAM 

HIRES 

INTERLACE 


SPRITES 


Ist dieses Flag gesetzt, so können zwei 
sogenannte »Play-Fields« verwendet 
werden. 

Wenn dieses Flag gesetzt wird, befindet 
sich der Amiga im »Hold-And-Modify 
- Modus«, kurz »HAM«. 

Ist dieses Flag gesetzt, so ist die maxi¬ 
male horizontale Auflösung 640 Pixels, 
andernfalls 320 Pixels. 

Durch das »Interlace-Flag« wird der 
Zeilensprung aktiviert. Somit sind ver¬ 
tikal max. 512 Pixels möglich. Ist dieses 
Flag nicht gesetzt, so beträgt die max. 
Auflösung vertikal nur 256 Pixels. 

Wenn Hardware-Sprites verwendet 
werden, so muß dieses Flag gesetzt 
sein. 


Beispiel: Soll die max. Auflösung 640 mal 512 Pixels betragen, 
so muß in »View-Modes« folgendes stehen: 

HIRES | INTERLACE 

Soll jedoch die geringe Auflösung von 320 mal 256 ein¬ 
geschaltet sein, so kann »View - Modes« auf »NULL« ge¬ 
setzt werden. 


Weitere Informationen folgen auf den nächsten Seiten. 
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2.1 Die View-Modi 

Wie im einführenden Kapitel »Screens« schon erwähnt, besteht beim 
AMIGA die Möglichkeit, verschiedene ViewModes, damit ist das Aussehen 
der Screens gemeint, zu wählen. Der Amiga kennt bisher 8 verschiedene 
Modi. 

HIRES 

Ist HIRES gesetzt, so können 640 Punkte horizontal dargestellt werden, 
andernfalls nur 320. Die Video-Hardware kann bis zu 700 Pixels darstellen, 
jedoch ist der Monitor nicht für größere Auflösungen als 640 Pixels horizon¬ 
tal geeignet. 

LACE 

Mit LACE wird die Video-Hardware des Amiga auf das Zeilensprung¬ 
verfahren eingestellt. Dieses Verfahren wird auch beim Farbfernseher ver¬ 
wendet. Dabei wird jedes Bild aus zwei Halbbildern zusammengesetzt. Im 
ersten Durchgang »schreibt« die Video-Hardware des Amiga alle geraden, 
im zweiten alle ungeraden Zeilen. In der Regel benötigt ein kompletter Bild¬ 
aufbau ohne Zeilensprungverfahren 1/60 Sekunde. Da aber nun 2 Bilder 
dargestellt werden müssen, verdoppelt sich die Zeit. Sie beträgt nun für den 
kompletten Bildaufbau 1/30 Sekunde. Dafür können mit LACE nun 512, an¬ 
statt nur 256 Zeilen dargestellt werden. Da der Monitor mit einer Bild¬ 
frequenz (Zeit für den Bildaufbau) von 50 Hz, das ist 1/50 Sekunde, arbeitet, 
fängt beim Einschalten des LACE-Modus das darzustellende Bild des 
AMIGA, leicht zu flackern an. 

HAM 

Dies ist ein Spezialmodus des Amiga. Er erlaubt die Darstellung aller 4096 
Farben zur selben Zeit, bei einer Auflösung von 320 x 256 Pixels. Normal ist 
es so, daß die Anzahl der BitMaps die maximale Anzahl der Farbregister und 
so die Anzahl der Farben bestimmt. Da maximal nur 6 BitMaps möglich 
sind, können rein theoretisch nur 2 A 6 = 64 verschiedene Farben dargestellt 
werden. Nun, wie kommt man in HAM zu 4096 Farben ? 

Der Name HAM verrät schon den ganzen Trick. HAM bedeutet »Hold And 
Modify«, zu deutsch »Halte und verändere«. Im HAM-Modus werden alle 6 
Bit-Maps verwendet. Die Bit-Maps 5 und 6 haben in diesem Modus eine 
besondere Bedeutung, sie werden dazu benutzt, die Bit-Kombinationen der 
Bit-Maps 1 bis 4 zu verändern. Ein HAM-Modus muß somit immer 5 oder 6 
Bit-Maps haben. 
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Das Ganze läuft nun so ab, daß jeweils die Bit-Kombination der Bit-Maps 5 
und 6 ermittelt werden. Es gibt also insgesamt 2^2 = 4 Kombinations¬ 
möglichkeiten für die Bit-Maps 5 und 6: 

Ist die Kombination gleich 00, wird die normale Farb-Selektion durchgeführt. 
Das heißt, die Bit-Kombination der Planes 1-4 wird dazu verwendet, eines 
der Farb-Register 0 bis 15 auszuwählen. Ist die Kombination gleich 01, wird 
die Bit-Kombination der Bit-Maps 1 bis 4 dazu verwendet, den roten Farb¬ 
wert des zuletzt angewählten Farbregisters zu verändern. Ist die Kombination 
gleich 10, wird die Bit-Kombination der Bit-Maps 1 bis 4 dazu verwendet, 
den grünen Farbwert des zuletzt angewählten Farbregisters zu verändern. Ist 
die Kombination gleich 11, wird die Bit-Kombination der Bit-Maps 1 bis 4 
dazu verwendet, den blauen Farbwert des zuletzt angewählten Farbregisters 
zu verändern. 

Werden nur 5 Bit-Maps verwendet ist der Wert des 6. Bit-Maps automatisch 
0, was bedeutet, daß entweder ein Farbregister mittels der Bitkombination 
der Planes 1 bis 4 angewählt wird, oder, wenn der Wert in der fünften Bit- 
Plane gleich 1 ist, der Rot-Anteil des zuletzt angewählten Farbregisters 
modifiziert wird. 

GENLOCK VIDEO 

Dieses Flag muß gesetzt sein, wenn mit dem Genlock Video Interface expe¬ 
rimentiert wird. Dabei werden die Signale zur Darstellung des Bildschirms 
mit einer fremden Videoquelle synchronisiert. Die Hintergrundfarbe wird 
gegen die fremde Videoquelle »ausgetauscht«. Während »Miami Vice« im 
Hintergrund läuft, kann im Vordergrund mit DeluxePaint gearbeitet werden. 

EXTRA HALFBRIGHT 

Dieses Bit schaltet, wenn es gesetzt ist, den Amiga in einen Spezial-Modus, 
der bei einer Auflösung von 320 x 256 Pixels und 320 x 512 Pixels eine Bit- 
Map-Anzahl von 6 und somit die Darstellung von 64 verschiedenen Farben 
erlaubt. 


SPRITES 


Dieses Flag muß gesetzt werden, wenn Hardware-Sprites verwendet werden 
sollen. 


VP HIDE 


Ist dieses Flag gesetzt, wird zwar ein Screen erzeugt, aber nicht dargestellt. 
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2.2 Die NewScreen-Structure 

Intuition stellt eine Reihe von nützlichen Hilfsmitteln bereit, die das Erstel¬ 
len und Anwenden von Custom-Screens erheblich vereinfachen. Damit In¬ 
tuition einen Custom-Screen bilden kann, muß der Anwender zunächst ver¬ 
schiedene Daten, die den Screenaufbau beschreiben, übergeben. Diese Da¬ 
ten sind einer NewScreen Struktur enthalten. 

Die NewScreen Struktur: 

struct NewScreen 
{ 

SHORT LeftEdge, TopEdge; 

SHORT Hidth, Height, Depth; 

UBYTE DetailPen, BlockPeni 
USHORT VlevModes; 

USHORT Type; 

struct TextAttr »Fonts; 

UBYTE «DefaultTltle; 
struct Gadget »Gadgets; 
struct BitMap »CustonBltMap; 

): 

Die einzelnen Variablen haben folgende Bedeutungen: 

LeftEdge X-Positon des Screens (derzeit keine Wirkung). 

TopEdge Y-Position des Screens nach dem Öffnen. 

Width Die Breite des Screens. Sie ist abhängig von dem 

verwendeten ViewModi: 

ViewMode = nicht HIRES = max. 320 Pixels, 
ViewMode = HIRES = max. 640 Pixels. 

Die Video-Hardware des AMIGA kann sogar eine 
Auflösung bis zu 700 Pixels horizontal darstellen. 
Leider ist aber der Monitor des AMIGA für eine 
solche Auflösung nicht mehr geeignet. 

Height Die Höhe des Screens. Auch Sie ist abhängig von 

dem verwendeten ViewModi: 

ViewMode = nicht LACE = max. 256 Pixels, 
ViewMode = LACE = max. 512 Pixels. 
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Depth Die Tiefe des Screens. Damit ist die Anzahl der 

BitMaps und die damit verbundene Anzahl der 
Farben gemeint. Maximal sind 6 BitMaps möglich. 
Aber nicht in allen Darstellungsarten sind sie ver¬ 
wendbar. Die maximale Anzahl der Bit-Maps, die 
noch verwendbar sind, ist abhängig von dem 
jeweiligen View-Mode und somit von der verwen¬ 
deten Auflösung: 


Auflösung: 

VlevMode: 

max. BitMaps 

max. Farben 

520 x 256 

- 

5 

52 

520 x 256 

EXTRA HALFBRIGHT 

6 

64 

520 x 256 

HAM 

6 

4096 

520 x 512 

LACE 

5 

52 

520 x 512 

LACE|EXTRA HALFBRIGHT 

6 

64 

640 x 256 

H1RES 

4 

16 

640 x 512 

HIRES1LACE 

4 

16 


DetailPen 


BlockPen 


ViewModes 


Type 


Fonts 


Hier muß die Farbregister-Nummer eingetragen 
werden, die z.B. für den Text in der Titelzeile ver¬ 
wendet werden soll. 

Hier muß die Farbregister-Nummer eingetragen 
werden, die beispielsweise für den Titel-Balken des 
Screens verwendet werden soll. 

Der AMIGA hat eine Vielzahl von Grafikauf¬ 
lösungen, die durch »ViewModes« bestimmt wer¬ 
den können, die schon im Zusammenhang mit der 
Bit-Tiefe erwähnt wurden. 

Hier wird im Normalfall CUSTOMSCREEN ein¬ 
getragen. Theoretisch kann hier auch 
WBENCHSCREEN verwendet werden, wodurch 
eine eigene Workbench geöffnet werden kann, was 
aber keinen allzu großen Zweck hat. Genaueres 
siehe unter der Screen-Structure. 

Falls ein besonderer Font (Zeichensatz) Verwen¬ 
dung finden soll, muß hier der Zeiger auf seine 
Structure eingetragen werden. Soll jedoch der 
momentane Intuition-Font verwendet werden, trägt 
man an dieser Stelle NULL ein. 
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Soll ein anderer Zeichensatz verwendet werden, 
bietet sich folgende Lösung: 

struct TextAttr Font * 

{ 

"emerald.font", Zeichensatzname 
20, Zeichensatzhöhe 

FS_N0RMAL, Darstellungsart 

FPF_DISKFONT Fontauf Diskette) 

Eingetragen wir dann an dieser Stelle in die 
NewScreen Structure »&Font«. 

Title Hier wird der Titel für den Screen-Balken einge¬ 

tragen. Falls kein Titel benötigt wird, kann einfach 
»NULL« eingetragen werden. 

Gadgets Hier wird in der Regel immer »NULL« eingetra¬ 

gen, da das Setzen des Gadgetpointers bei Ver¬ 
wendung von Gadgets von Intuition selbst über¬ 
nommen wird. 

CustomBitMap Dieser Zeiger muß auf eine selbst erstellte 

BitMap-Structure zeigen, wenn 

CUSTOMBITMAP verwendet wird, ansonsten ist 
der Wert dieser Variable »NULL«. 

Übergeben wird Intuition diese NewScreen-Structure mit OpenScreen(). 
Intuition fügt diese Parameter in eine größere Struktur, die Screen-Structure, 
ein. Beim Öffnen des Screens übergibt Intuition den Pointer auf diese 
größere Struktur automatisch an das Programm zurück. Er ist sehr wichtig 
für weitere Anwendungen, wie z.B. für das Zeichnen auf den Screen. 

Zur Verdeutlichung ein Beispiel: 

/* definieren der größeren Structure */ 

struct Screen *screen; 

/* nun Definition der Nev-Screen-Structure */ 

struct NevScreen nevscreen « 

{ 


0, 

/* x - Parameter 

*/ 

0. 

/* y - Parameter 

*/ 

520, 



256, 

/* Auflösung 

»/ 

6, 

/* Tiefe 

*/ 

0, 

1, 

/* Zeichenstifte 

*/ 

HAM, 

/* VlevModi 

*/ 

CUSTOMSCREEN, 

/* Type 

»/ 

NULL, 

/» Font 

«/ 
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"HAM-DEMO", /* Screen-Titel */ 

NULL, /» Gadget-Pointer*/ 

NULL /* BitMap-Pointer*/ 

} 

main() 

{ 

/* öffnen des Screens ult der NeuScreen-Structure und übernehmen des 
Pointers der größeren Screen-Structure */ 

screen - (struct Screen *)OpenScreen(&newscreen); 

/* Setzen der Farbe mit Hilfe des Pointers auf die größere Structure, der 
Screen-Struktur -> Sscreen. Dabei wird der VievPort von der Screen- 
Struktur abgeleitet. 

&screen->ViewPort »/ 

SetRGB4(&screen->ViewPort, 0, 15, 15. 15): 

} 
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2.3 Die Screen-Structure 


Wie Sie im vorhergehenden Abschnitt gelesen haben, ist die New-Screen 
Structure nur eine Art »Notiz-Zettel«, die Intuition nur das Nötigste für den 
Screenaufbau mitteilt. Dieser »Notiz-Zettel« wird nach dem Öffnen des 
Screens nicht mehr benötigt, da eine erweiterte Structure zurückgegeben 
wird. 

Auf die erweiterte, größere Structure, die Screen-Structure wollen wir nun 
etwas näher eingehen: 

Die Screen-Structure: 

struct Screen 

{ 

struct Screen »NextScreen; 
struct Window »FlrstWindov; 

SHORT LeftEdge, TopEdge, Wldth, Height; 

SHORT MouseY, MouseX; 

USHORT Flags; 

UBYTE Tlte; 

UBYTE DefaultTitle; 

BYTE BarHeight, BarVBorder, BarHBorder, 

MenuVBorder, MenuHBorder; 

BYTE WBorTop, WBorLeft, WBorRlght, WBorBottom; 

struct TextAttr »Font; 

struct ViewPort VlewPort; 

struct RastPort RastPort; 

struct BitMap BltMap; 

struct Layer_Info Layerlnfo; 

struct Gadget »FlrstGadget; 

UBYTE DetailPen, BlockPen; 

USHORT SaveColorB; 
struct Layer »BarLayer; 

UBYTE »ExtData; 

UBYTE »UserData; 

): 

Im Vergleich zur NewScreen-Structure sind einige Daten, wie ViewPort und 
RastPort hinzugekommen. Dies sind wichtige Pointer, die z.B. zum Setzen 
der Farbe oder zum Zeichen benötigt werden. 

Im einzelnen bedeuten die Variablen folgendes: 

NextSceen Dies ist ein Pointer auf den nächsten Screen. 

FirstWindow Dies ist ein Pointer auf das erste verwendete 

Window in diesem Screen. 

LeftEdge, TopEdge, 

Width,Height Screendimensionen, siehe NewScreen-Struktur 
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MouseY, MouseX 

X- und Y-Koordinaten der Maus, relativ gesehen 
zur oberen linken Ecke; 

Flags 

Diese Flags werden von Intuition gesetzt. Sie be¬ 
schreiben die unterschiedlichen Screens die unter 
Intuition möglich sind: 


SCREENTYPE 

alle Definitionen sind 
möglich. 


Definitionen: 



WBENCHSCRN 

Die Workbench. 


CUSTOMSCREEN = 

Benutzer-Screen. 


SHOWTITLE 

Ist dieses Flag gesetzt, 
so wird die Titelleiste 
angezeigt. Dieses Flag 
kann mit ShowTitle() 
verändert werden. 


BEEPING 

Dieses Flag wird gesetzt, 
wenn der Screen auf¬ 
blinkt (beept), siehe 
DisplayBeep(). 


CUSTOMBITMAP = 

Wenn ein eigenes 

BitMap verwendet wer¬ 
den soll, muß dieses 
Flag gesetzt sein. 


Title Screen Titel der Titelleiste. 

DefaultTitle WindowTitel für Windows ohne Screen-Titel. 

BarHeight, BarVBorder, 

BarHBorder, 

MenuVBorder, 

MenuHBorder Dimensionen der Titel- und Menüleiste 

WBorTop, WBorBottom, 

WBorRight, WBorLeft Dimension der Titelleiste aller Windows in diesem 

Screen. 

Font Screen-Font. Siehe NewScreen-Struktur. 
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ViewPort Der Pointer auf den ViewPort des Screens. Der 

ViewPort enthält weitere X- und Y- Dimensionen 
des Screens sowie Pointer zu einer Liste, die den 
Copper und somit die Videodarstellung steuert. 

RastPort Pointer auf den RastPort des Screens. Der 

RastPort enthält eine Liste über die verwendeten 
Zeichenstifte, Zeichen-Modi u.s.w. 

BitMap Pointer auf das vom Benutzer definierte BitMap. 

Siehe NewScreen-Struktur. 

Layerlnfo Layer Information. 

FirstGadget Pointer auf das erste verwendete Gadget. 

Siehe NewScreen-Struktur. 

DetailPen, BlockPen Zeichenstifte. Siehe NewScreen-Struktur. 

SaveColorO Diese Variable enthält den Wert für die Farbe, die 

bei DisplayBeep verwendet wird. Sie wird von 
Intuition gesetzt. 

BarLayer Pointer für die Darstellung der Titel-leiste. 

ExtData, UserData Hier kann der Benutzer eigene Pointer auf seine 
eigenen Daten eintragen. 

Nicht alle Variablen und Pointer sind von großer Bedeutung. Merken sollten 
Sie sich jedoch, daß sie von dieser Structure, der Screen-Stucture, sowohl an 
den RastPort- als auch an den ViewPort-Pointer gelangen können. 

An den Pointer dieser Screen-Structure gelangen Sie, wie schon beschrieben, 
wenn Sie mit OpenScreenQ die NewScreen-Structure an Intuition übergeben 
und somit einen Screen öffnen. 

Möchten Sie nun nachträglich Veränderungen vornehmen, z.B. den Titel än¬ 
dern, so können Sie das folgendermaßen: 

&screen->Tltle = "Markt & Technik"; 

oder wenn Sie den RastPort benötigen, können Sie so darauf zugreifen: 
&screen->RastPort; 

Sie verwenden also jeweils den Pointer des Screens, in dem Fall also 
&screen, mit einem »Pfeil« auf den jeweiligen Eintrag, den Sie benötigen. 
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2.4 Die Screen-Befehle 

2.4.1 CloseScreen 

Syntax: CloseScreen(Screen); 

Funktion: Ein geöffneter Screen wird geschlossen. 

Parameter: Screen -> Zeiger auf die Screen-Structure des 

Screens, der geschlossen werden soll. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Screen *Screen; 

Sonstiges: Wenn ein Screen mit OpenScreen(&Screen) geöffnet wurde, 

kann er mit CloseScreen(&Screen) geschlossen werden. 

Referenz: Siehe Anwendungsbeispiele HAM-, 

Extrahalfbright-, 

Screen-Demo. 

Siehe auch CloseScreen. 

2.4.2 CloseWorkbench 

Syntax: erfolg = CloseWorkbench(); 

Funktion: Diese Routine schließt den Workbench-Screen. Wenn die 

Workbench geöffnet ist, wird getestet, ob verschiedene 
Windows auf ihr geöffnet sind. Trifft dies zu, so bleibt die 
Workbench geöffnet und »erfolg« nimmt den Wert »FALSE« 
an. Falls keine Windows auf der Workbench geöffnet sind, 
wird der Workbench-Screen geschlossen und »erfolg« nimmt 
den Wert »TRUE« an. 

Parameter: Keine Parameter. 

Ergebnis: erfolg -> ist TRUE, wenn die WorkBench ge¬ 

schlossen werden konnte, ansonsten ist 
»erfolg« FALSE. 

Datentyp: bool erfolg; 

Sonstiges: Dieser Befehl kann angewendet werden, um Speicherplatz zu 

gewinnen. 

Siehe Screen-Demo. 


Referenz: 
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2.4.3 DisplayBeep 

Syntax: DisplayBeep(Screen); 

Funktion: DisplayBeep(&Screen) läßt den Screen kurz in einer anderen 

Hindergrundfarbe aufblinken. 

Parameter: Screen - > ist der Pointer auf die jeweilige Screen- 

struktur. Wird der Parameter mit 

»NULL« angegeben, so blinken alle 

geöffneten Intuition-Screens auf. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Screen *Screen; 

Sonstiges: Wenn der Programmanwender gewarnt werden soll. Ein 

Beispiel hierfür finden wir beim BASIC-Interpreter des 
AMIGA. Tritt ein Syntax-Error auf, so wird die DisplayBeep- 
Funktion aufgerufen. 

Referenz: Siehe Screen-Demonstration. 

2.4.4 MakeScreen 

Syntax: MakeScreen(Screen); 

Funktion: Richtet den ViewPort eines Intuition CustomScreens ein. 

Parameter: Screen -> ist der Pointer auf die jeweilige Screen 

- Structure. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Screen *Screen; 

Sonstiges: Ist ein Screen gelöscht und es besteht der jeweilige Pointer 

zur Screen-Struktur noch, so kann mit MakeScreen(&Screen) 
der Screen wieder »zurückgeholt« werden. 

Nach dem Aufruf von MakeScreen(&Screen) kann mit Hilfe 
der Funktion RethinkDisplayQ der neue ViewPort des 
Screens in die »Intuition Wiedergabe« aufgenommen werden. 
Gleichzeitig werden durch RethinkDisplay() alle anderen 
ViewPorts »aufgefrischt«. 

Siehe auch RethinkDisplay 


Referenz: 
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2.4.5 

MoveScreen 


Syntax: 

MoveScreen(Screen,dx,dy); 


Funktion: 

MoveScreen bewegt (scrollt) den angegebenen Screen in der 
Vertikalen. 


Parameter: 

Screen -> Zeiger auf die Screen-Structure des 

Screens, der bewegt werden soll. 



dx,dy -> Anzahl der Punkte, um die der Screen 

bewegt werden soll. Es sind auch 
negative Werte zulässig. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Screen *Screen; 
int dx, dy; 


Sonstiges: 

Derzeit kann noch nicht in der Horizontalen bewegt werden. 
Aus diesem Grund hat »dx« noch keine Bedeutung. 



Dieser Befehl hat die gleiche Wirkung, wie das 
»Herunterziehen« eines Screens mit der Maus. 


Referenz: 

Siehe auch Screen-Demo. 

2.4.6 

OpenScreen 


Syntax: 

Screen = OpenScreen(NewScreen); 


Funktion: 

Öffnen eines Screens mit den Parametern, die in der 
NewScreen-Struktur festgelegt sind. 


Parameter: 

NewScreen -> Zeiger auf die NewScreen-Structure, 

die die Daten für den Screen enthält. 


Ergebnis: 

Screen -> Zeiger auf die Screen-Structure des 

geöffneten Screens. 


Datentyp: 

struct NewScreen *NewScreen; 
struct Screen *Screen; 


Sonstiges: 

Weitere Erklärungen finden Sie unter Kapitel 2, 2.1, 2.2 und 
2.3. 
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Referenz: Siehe auch ShowTitle 

Screen-Demo 
HAM-Demo 
Extrahalfbrigth-Demo 
Kapitel 2 DerScreen 

2.4.7 OpenWorkBench 


Syntax: 

erfolg = OpenWorkbench(); 

Funktion: 

OpenWorkbench() versucht die Workbench wieder zu öffnen. 

Parameter: 

Keine Parameter. 

Ergebnis: 

erfolg -> ist TRUE, wenn sie geöffnet werden 

konnte, ansonsten ist »erfolg« FALSE. 

Datentyp: 

bool erfolg; 

Sonstiges: 

Wenn mit CloseWorkbench() die Workbench geschlossen 
worden ist, kann sie mit OpenWorkbench wieder geöffnet 
werden. 

Referenz: 

Siehe auch CloseWorkbench(). 

2.4.8 RemakeDisplay 


Syntax: RemakeDisplayQ 


Funktion: Diese Routine frischt alle augenblicklichen ViewPorts der 

Intuition-Screens durch Aufrufen der Funktion 
MakeScreen(&Screen) auf. Danach wird RethinkDisplay auf¬ 
gerufen, welches die Relationen des Screens und die Dar¬ 
stellungsliste des Coppers auffrischt. 

Parameter: Keine Parameter. 

Ergebnis: Kein Ergebnis. 

Datentyp: Keine Variablen. 

Sonstiges: Diese Routine kann einige Millisekunden benötigen, bevor 

mit dem weiteren Ablauf des Programms vorgefahren wird. 

Siehe auch RethinkDisplay. 


Referenz: 
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2.4.9 

RethinkDisplay 


Syntax: 

RethinkDisplay(); 


Funktion: 

Zum Auffrischen der Relationen des Screens, sowie der Dar¬ 
stellungsliste des Coppers. 


Parameter: 

Keine Parameter. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

Keine Variablen. 


Sonstiges: 

Diese Routine benötigt einige Millisekunden, bevor mit dem 
weiteren Programmablauf fortgefahren wird. 


Referenz: 

Siehe auch RemakeDisplay. 

2.4.10 

ScreenToBack 


Syntax: 

ScreenToBack(Screen); 


Funktion: 

Der Screen wird in den Hintergrund gebracht und von ande¬ 
ren geöffneten Screens überdeckt. 


Parameter: 

Screen -> Zeiger auf die Screen-Structure des 

Screens, der in den Hintergrund 
gebracht werden soll. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Screen *Screen; 


Sonstiges: 

Wenn mit ScreenToFront der Screen in den Vordergrund ge¬ 
bracht wurde, kann er mit ScreenToBack(&Screen) wieder in 
den Hintergrund gebracht werden. 


Referenz: 

Siehe auch ScreenToBack 

WBenchToBack 

WBenchT oFront 

2.4.11 

ScreenToFront 


Syntax: 

ScreenT oFront(Screen); 


Funktion: 

Bringt den jeweiligen Screen in den Vordergrund, andere ge¬ 
öffnete Screens werden überlagert.Parameter: Screen -> 
Zeiger auf die Screen-Structure des Screens, der in den Vor¬ 
dergrund gebracht werden soll. 


Ergebnis: 

Kein Ergebnis. 
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Datentyp: struct Screen *Screen; 

Sonstiges: Wenn ein Screen mit ScreenToBack(&Screen) in den Hinter¬ 

grund gebracht wurde, kann er mit ScreenToFront(&Screen) 
nach vorne gebracht werden. 

Referenz: Siehe auch ScreenToBack 

WBenchToBack 
WBenchT oFront 


2.4.12 SetRGB4 


Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


SetRGB4(ViewPort,reg,rot,grün,blau) 

Setzen eines Farbregisters des angegebenen Screens mit einer 
beliebigen Farbe. 


ViewPort 

-> 

Zeiger auf den ViewPort des jeweilige! 
Screens. 

reg 

-> 

Nummer des Farbregisters 

rot 

-> 

Rot-Anteil. 16 Stufen möglich. 

grün 

-> 

Grün-Anteil. 16 Stufen möglich. 

blau 

-> 

Blau-Anteil. 16 Stufen möglich. 


Kein Ergebnis. 

struct ViewPort *ViewPort; 

int reg, rot, grün, blau; 

Der ViewPort-Pointer muß von dem jeweiligen Screen, wo 
die Farbe verändert werden soll, abgeleitet sein.Dies ge¬ 
schieht wie folgt: 

&Screen -> ViewPort. 

Siehe Screen-Demonstrationen 


Referenz: 
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2.4.13 ShowTitle 


Syntax: 

ShowTitle(Screen,mode); 

Funktion: 

Durch diese Funktion kann bestimmt werden, ob die Titel¬ 
leiste im Vordergrund oder im Hintergrund von »Backdrop«- 
Windows angezeigt werden soll. 

Parameter: 

Screen - > ist ein Zeiger auf die jeweilige Screen- 

Structure. 


Mode -> muß TRUE gesetzt werden, wenn die 

Titelleiste vor Backdrop-Windows er¬ 
scheinen soll. Ansonsten muß »mode« 
gleich FALSE sein. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct Screen *Screen; 
bool Mode; 

Sonstiges: 

Nachdem ein Screen mit OpenScreen(&Screen) geöffnet 
wurde, wird ShowTitle automatisch auf »TRUE« gesetzt. 
Dies kann mit ShowTitle(&Screen, mode) verändert werden. 

Referenz: 

OpenScreen. 

WBenchToBack 

Syntax: 

erfolg = WBenchToBack(); 

Funktion: 

Die Workbench wird nach hinten gebracht und wenn andere 
Screens geöffnet sind, von diesen verdeckt. 

Parameter: 

Keine Parameter. 

Ergebnis: 

erfolg -> ist TRUE, wenn die Workbench in den 

Hintergrund gebracht werden konnte. 

Datentyp: 

bool erfolg; 

Sonstiges: 

Wenn die Workbench andere geöffnete Screens überdeckt, 
können diese durch WBenchToBack() nach vorne gebracht 
werden. 

Referenz: 

Siehe auch ScreenToFront 

ScreenToBack 

WBenchToFront 
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2.4.15 WBenchToFront 


Syntax: 

erfolg = WBenchToFront(); 

Funktion: 

Bringt die Workbench in den Vordergrund, wenn sie von 
anderen Screens überdeckt war. 

Parameter: 

Keine Parameter. 

Ergebnis: 

erfolg -> ist TRUE, wenn die Workbench in den 

Vordergrund gebracht werden konnte 

Datentyp: 

bool erfolg; 

Sonstiges: 

Wird die Workbench von anderen Screens überdeckt, so kann 
sie mit WBenchToFront() nach vorne gebracht werden. 

Referenz: 

Siehe auch WBenchToBack 

ScreenToBack 

ScreenToFront 


1 /#******##******#**##*****##**** 

2 

3 Screen-Demonstration 

4 last update 26/05/87 

5 von Joerg Koch und Frank Kremser 

6 <c> Markt & Technik 1987 

7 

Q #*#**##*#**#***##*#*#***####*#** 

9 

10 Diese Demonstration zeigt die Wirkung einiger Screen-Befehle. 

11 Workbench kann nur geschlossen werden, wenn auf ihr kein CLI- 

12 Window geoeffnet ist. 

13 

14 *******************************/ 

15 


16 

ttinclude <exec/types.h> 

/% 

Einladen der Include-Files %/ 

17 

#include <intuition/intuition.h> 



18 




19 

struct IntuitionBase *IntuitionBase; 

/* Lib-Zeiger */ 

20 

struct GfxBase *GfxBase; 



21 




22 

struct NewScreen LowScreen = 

/% 

Screen definieren */ 

23 

< 



24 

o, 

/% 

Linke Ecke #/ 

25 

o, 

/% 

Obere Ecke */ 

26 

320, 

/* 

Breite */ 

27 

256, 

/* 

Hoehe #/ 

28 

2, 

/* 

Tiefe */ 

29 

0, 

/* 

DetailPen */ 

30 

1» 

/* 

BlockPen %/ 

31 

NULL, 

/* 

Flags */ 

32 

□JSTOMSCREEN, 

/* 

Screen-Typ #/ 

33 

NULL, 

/* 

Zeichensatz */ 

34 

"Screen mit 320 x 256 Pixels", 

/* 

Screen-Titel %/ 

35 

NULL, 

/* 

Zeiger auf das erste Gadget #/ 

36 

NULL, 

/* 

Zeiger auf die BitMap %/ 

37 

>J 




38 
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39 

struct NewScreen HighScreen = 



40 

i 



41 

0, 



42 

64, 



43 

640, 



44 

512, 



45 

2, 



46 

0 , 1 , 



47 

HIRES!LAGE, 



48 

CUSTOMSCREEN, 



49 

NULL, 



50 

"Screen mit 640 x 512 Pixels", 



51 

NULL, 



52 

NULL, 



53 

>; 



54 




55 

main() 



56 

< 



57 

struct Screen *LScreen; 



58 

struct Screen *HScree. 



59 




60 

LONG zahl; 



61 




62 

IntuitionBase = (struct IntuitionBase 

*) 

/* Intuition oef-fnen */ 

63 

GpenLibrary("intuition.library",0); 



64 

if(IntuitionBase == NULL) exit(FALSE); 



65 




66 

G-fxBase = (struct G-fxBase *) 


/* Graphics oeffnen */ 

67 

GpenLibrary("graphics.library",0); 



68 

lf (G-fxBase = NULL) exit(FALSE); 



69 




70 

lf((LScreen=(struct Screen*) 



71 

OpenScreen(&LowScreen)) = NULL) exit(FALSE); 

72 



/* Screens oe-f-fnen */ 

73 

i-f < (HScreen=(struct Screen*) 



74 

OpenScreen(&HighScreen))— NULL) exit(FALSE); 

75 




76 

SetRGB4<&LScreen->Vie^fort,0,15,0,0); 



77 


/* 

Hintergrund-farben setzen */ 

78 

SetRGB4(&HScreen->ViewPort,0,0,0,15); 



79 




80 

ScreenToFront(LScreen); 

/* 

LScreen nach vorne */ 

81 




82 

■for(zahl = l; zahl<256;-»••♦•zahl) 

/* 

Screens animieren */ 

83 

MoveScreen (LScreen ,0,1); 



84 




85 

•for( zahl = l; zahl<16;-»•-»•zahl) 



86 

MoveScreen(HScreen,0,-4); 



87 




88 

■for ( zahl = l; zahl < 128; ++zahl) 



89 

MoveScreen(LScreen,0,-2); 



90 




91 

WBenchToFront(); 

/* 

Workbeneh nach vorne */ 

92 




93 

■for ( zahl = l; zahl<50000;-»-»-zahl); 



94 




95 

CloseWorkBench<); 

/* 

Workbeneh schliessen */ 

96 




97 

■for ( zahl = l; zahl<1000;++ zahl) 



98 

DisplayBeep(NULL); 

/* 

Screens Beepen */ 

99 




100 

•for(zahl=l;zahl<200000; ++zahl); 



101 
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102 Open Work Bene h( ); 

103 

104 far( zahl=i;zahl<50000;++zahl); 

105 

106 WBenchToBack(); 

107 

108 -for( zahl=l; zahl <500000; ++zahl); 

109 

110 CloseScreen(LScreen); 

111 CloseScreen(HScreen); 

112 CloseLibrarytIntuitionBase); 

113 CloseLibrary(G-fxBase); 

114 ) 


1 /******************************* 

2 

3 Hai-fbri te-Demonstration 

4 last update 26/05/87 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt & Technik 1987 

8 

9 Diese Demonstration zeigt, wie der ExtrahaHbrite-Modus angewendet wird. 

10 Die Farben 32 bis 63 haben nur die halbe Intensitaet, wie die Farben 0 bis 

11 31. Sie koennen nicht etwa als eigene Farbregister gesetzt werden. 

12 

13 *******************************/ 

14 

15 #include <exec/types.h> /% Einlesen der Include-Files */ 

16 #include <exec/tasks.h> 

17 #include <exec/libraries.h> 

18 ttinclude <exec/devices.h> 

19 #include <devices/keymap.h> 

20 #include <graphics/copper.h> 

21 tfinclude <graphics/display.h> 

22 #include <graphics/g+xbase.h> 

23 #include <graphics/text.h> 

24 #include <graphics/view.h> 

25 ttinclude <graphics/gels.h> 

26 #include <graphics/regions.h> 

27 #include <hardware/blit.h> 

28 #include <intuition/intuition.h> 

29 #include <intuition/intuitionbase.h> 

30 

31 

32 struct 6-fxBase *G-fxBase; /% Lib - Zeiger */ 

33 struct IntuitionBase *IntuitionBase; 

34 

35 struct Screen *colscreen; 

36 

37 struct NewScreen newscreen = /# Screen de-finieren */ 

38 i 

39 0, 

40 0, 

41 320, 

42 512, 

43 6, 

44 0, 

45 31, 

46 LACE !EXTRA_HALFBRITE, 

47 CUSTGMSCREEN, 

48 NULL, 


/% Workbench oe-f-fnen */ 


/# Workbench nach hinten */ 


/* Screens und Libs schl i essen */ 


62 Der Screen 


49 "Extra-Haifbrite-Demo bei 320 x 512", 

50 NULL, 

51 NULL 

52 >; 

53 

54 struct Intu iM essage #message; 

55 

56 

57 main() 

58 { 

59 LONG warte; 

60 USHÜRT schieitel; 

61 USHORT schleife2; 

62 

63 if ((IntuitionBase = (struct IntuitionBase #) 

64 OpenLibrary("intuition.library", 0)) =0) exit(); 

65 /# Libs oet-fnen %/ 

66 if ((GfxBase = (struct GfxBase *) 

67 OpenLibraryt"graphics.library", 0)) =0) exit(); 

68 

69 co1screen = (struct Screen % >OpenScreen(&newscreen); 

70 i-f (colscreen == 0) 

71 ( /# Screen oe-f-fnen */ 

72 CloseLibrary(G-f xBase); 

73 CloseLibrary(IntuitionBase); 

74 exitO; 

75 > 

76 /* Die Farben der ersten 32 Farbregister setzen */ 

77 -for (schleifel = 0; schlei-fel < 8; sc hl ei-fei-«-*-) 

78 { 

79 SetRGB4(&colscreen->ViewPort, schlei-fei+24, schlei-fei »2, 

80 schleitel*2,schlei-fel*2); 

81 SetRGB4(&colscreen->ViewPort,schleifel,schleifel*2,0,0); 

82 SetRGB4(&colscreen->ViewPort,schleifel+8,0,schleifel*2,0); 

83 SetRGB4(&colscreen->ViewPort,schleifel+16,0,0,schleifel*2); 

84 > 

85 /* Die Farben auf den Schirm bringen */ 

86 for (schleifel = 0; schleifel < 8; schleifel++> 

87 for (schleife2 = 0; schleife2 < 8; schleife2++) 

88 ( 

89 SetAPen(&colscreen->RastPort,schleifel + 8 * schleife2); 

90 RectFil1(&colscreen->RastPort,schleifel*40,schleife2*62+10, 

91 schleifel*40+39,schleife2*62+72); 

92 > 

93 

94 for(warte = 0; warte < 500000; ++warte); 

95 

96 CloseScreen(colscreen); 

97 CloseLibrary(GfxBase); 

98 CloseLibrary(IntuitionBase); 

99 > 


/% Screen und Libs schl 1 essen */ 
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##*#####**#*###*#;M#*#*#*#**#*#* 

Diese Demonstration zeigt alle 4096 Farben des AMIGA auf einmal, wofuer der 
HAM-Modus verwendet wird. 

********:M**********:M)M*******/ 


#inclüde 
#include 
#include 
#inclüde 
#include 
#include 
#include 
#include 
#include 
ttinclude 
#include 
#include 
#include 
#include 
#include 


<exec/types.h> 
<exec/tasks.h> 

<exec/1ibrarles.h> 
cexec/devices.h> 
<devices/keymap.h> 
<graphics/copper.h> 
<graphics/display.h> 
<graphics/gfxbase.h> 
<graphics/tex t.h> 
<graphics/view.h> 
<graphics/ge1s.h> 
<graphics/regions.h> 

< hardware/b1it.h> 
<intuition/intuition.h> 
<intuition/Intuitionbase.h> 


GfxBase »GfxBase; /* Lib-Zeiger */ 

IntuitionBase »lntuitionBase; 


struct 
struct 

struct RastPort *rp; 

struct ViewPort *vp; 

struct Screen #screen; 

struct NewScreen newscreen = 

( 

0, 

0, 

320, 

256, 

6, 

0, 

1, 

HAM, 

CUS1ÜMSCREEN, 

NULL, 

NULL, 

NULL 

>; 


/% New Sc r een Demo */ 

/# Linke Ecke #/ 

/* Obere Ecke #/ 

/* Breite #/ 

/* Hoehe */ 

/* Tiefe */ 

/* DetailPen ♦ / 

/# BlockPen */ 

/# Hold and Modify ViewMode */ 
/# Screen ~ Typ */ 


main() 
i 

L0NG warte; 

SHORT x, y, r, g, b; /* oeffnen der Libs #/ 


GfxBase = (struct GfxBase *)0penLibrary(“graphics.1ibrary ", 0); 
if (GfxBase == NULL) exit(>; 


IntuitionBase = (struct IntuitionBase *)0penLibrary("intuition.1ibrary", 0) 
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65 

lf (lntuitionBase == NULL) 


66 

{ 


67 

CloseLibrary(G-f xBase); 


68 

exit(); 


69 

> 

/# HAM - Screen oe-ftnen #/ 

70 



71 

screen = (struct Screen *)0penScreen(&newscreen); 

72 

l-f (screen == NULL) 


73 

i 


74 

CloseLibrary(IntuitionBase); 

/* Wenn Fehler -> ENDE */ 

75 

CloseLibrary(G-fxBase); 


76 

exit(); 


77 

> 


78 



79 

vp = &screen->ViewPort; 


80 

rp = &screen->RastPort; 


81 



82 

SetRGB4(vp, 0, 0, 0, 0); 


83 



84 

■for(r = 0; r < 16; r++) 

/* R-, G- und B-Farbenspiel beginnen #/ 

85 

-for(g = 0; g < 16; g++) 

/% HAM -färben, durch halten der 5. */ 

86 

for(b = 0; b < 16; b++) 

/* und 6. BitPlane, darstellen #/ 

87 

{ 

/* Genaue Beschreibung der HAM- #/ 

88 

x = r # 20; 

/* -finden Sie bei Kapitel 2.1 */ 

89 

y=g+ (b # 16); 

/* Die ViewModes ! */ 

90 

SetDrMd(rp, JAM1); 


91 



92 

SetAPen(rp, r + 0x20); 


93 

Move < rp, x, y); 


94 

Draw(rp, x, y); 


95 



96 

x++; 


97 

SetAPen(rp, g + 0x30); 


98 

Move ( rp, x, y ); 


99 

Draw(rp, x, y); 


100 



101 

X++J 


102 

SetAPen(rp, b + 0x10); 


103 

Move(rp, x, y); 


104 

Draw(rp, x + 17, y>; 


105 

> 

/* Schlei-fe */ 


106 

107 -for(warte = 0; warte < 1000000; warte++); 

108 

109 CloseScreen(screen); 

110 CloseLibrary( Intuition Base); 

111 CloseLibrary(G-fxBase); 

112 > 


/* Libs und Screen schliessen %/ 
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Das Window 


Das Window ist neben dem Screen das wohl wichtigste Element für die Pro¬ 
grammierung, da im Normalfall sämtliche Ein-/Ausgabeoperationen über 
Windows ablaufen. Intuition stellt dem Programmierer mit den Windows 
eine Vielzahl von Möglichkeiten zur Verfügung, ohne daß dieser sich um das 
Handling zu kümmern braucht. So kann man für sein Programm einfach ein 
Window öffnen, und ist damit vollkommen unabhängig von weiteren Pro¬ 
grammen, die eventuell gleichzeitig ablaufen. Auch kann der Benutzer des 
Programms später selbst das Window positionieren oder aber in den Hinter¬ 
grund »klicken«, ohne daß der Programmierer zuvor sein Programm auf all 
diese Fälle vorbereitet haben muß, da Intuition mit dem Öffnen des 
Windows die Kontrolle der Systemgadgets übernimmt. 

Aber Windows erleichtern nicht nur das Handling, sondern ermöglichen 
auch eine Vielzahl von Besonderheiten. So kann der Benutzer das Window 
beliebig vergrößern, verkleinern oder beiseite »legen«. Aber auch für den 
Programmierer bieten sich einige Vorzüge. So kann der Programmierer über 
Windows eigene Gadgets verwenden, was die Bedienerführung eines Pro¬ 
gramms erheblich vereinfacht. Auch die Pull-Down-Menüs, die der Pro¬ 
grammierer über Windows in seinem Programm verwenden kann, verein¬ 
fachen die Kommunikation des Benutzers mit dem Programm sehr. 

Zudem ist ein Programm, das mit Gadgets und Menüs arbeitet, um ein Viel¬ 
faches attraktiver, als ein vergleichbares Programm, das die Eingaben über 
die Tastatur verlangt. 

Es können soviele Windows geöffnet werden, wie der Speicherplatz des 
Amiga es erlaubt. Im Normalfall dürfte aber ein Window pro Programm 
genügen. Mehrere Windows sind nötig, wenn mehrere Programme gleich¬ 
zeitig ablaufen (Multitasking) oder wenn das Programm Ein- und Ausgabe 
trennen will. Wie viele Windows geöffnet werden müssen, hängt also ganz 
vom Aufgabengebiet ab. 
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3.1 Window-Typ 

Dem Programmierer stellt Intuition verschiedene Möglichkeiten für 
Windows zur Verfügung: 

Normal-Window: 

Dies ist kein spezielles Window mit besonderen Fähigkeiten. Dieses Window 
wird im Normalfall immer benutzt. Ein Beispiel für dieses Window ist die 
Workbench-Uhr. 

Borderless-Window: 

Dieses Window hat im Prinzip die gleiche Funktion wie das normale 
Window. Der einzige Unterschied ist, daß bei diesem Window keine Rand¬ 
begrenzungen gezeichnet werden, die in bestimmten Situationen störend sein 
können. 

Gimmezerozero-Window: 

Auch dieses Window hat im Prinzip die gleiche Funktion wie ein normales 
Window. Der Unterschied besteht jedoch darin, daß ein solches Window aus 
zwei Teilen besteht. Das normale Window wird mitsamt dem Inhalt auf den 
Screen gezeichnet, benötigt also keinen zusätzlichen Speicherplatz, während 
der Inhalt beim Gimmezerozero-Window getrennt vom Window-Rand ge¬ 
speichert wird. Das bedeutet, daß bei einem Gimmezerozero-Window nicht 
darauf geachtet werden muß, ob über den Rand gezeichnet wird, was bei 
einem normalen Window schon mal passieren kann. 

Zur Kontrolle eines Gimmezerozero-Windows stehen dem Programmierer 
in der Window-Structure einige spezielle Variablen zur Verfügung: 

GZZMouseX und GZZMouseY enthalten die Mauskoordinaten relativ zum 
inneren Windowbereich. 

GZZWidth und GZZHeight enthalten die momentane Breite und Höhe des 
inneren Windowbereiches in Pixel. 
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SuperBitMap-Window: 

Das SuperBitMap-Window ist das aufwendigste von allen Window-Typen. 
Für dieses Window muß ein eigenes BitMap erstellt werden, da sämtliche 
Daten in dieses BitMap geschrieben werden. Von dort werden sie auf den 
Screen kopiert, wodurch das Window völlig unabhängig ist. Das BitMap muß 
mindestens so groß sein, wie die maximale Größe des Windows, da ständig 
alle Daten in der BitMap gespeichert werden. Das bedeutet, daß beim 
Zeichnen in das Window keine Rücksicht auf die momentane Windowgröße 
genommen werden muß, da das Window eventuell nur einen Ausschnitt aus 
dem gesamten Bereich zeigt. 

Das BitMap wird folgendermaßen erstellt: 

InitBltMap(BitMapPtr.Tiefe.Breite.Höhe); 

Dieser Befehl wird an anderer Stelle noch genau erläutert. Hier brauchen Sie 
nur zu wissen, welche Bedeutung die Parameter haben: 

- BitMapPtr ist ein Zeiger vom Typ BitMapPtr, der bei Aufruf der Funk¬ 
tion noch nicht belegt ist. Nach dem Aufruf zeigt er auf die 
BitMapStructure des BitMap’s. 

- Tiefe gibt die Anzahl der Bit-Planes an, das heißt die Anzahl der mög¬ 
lichen Farben. Bei einem SuperBitMap-Window auf der Workbench 
muß das BitMap eine Tiefe von 2 haben, da die Workbench ebenfalls 
nur eine Bit-Tiefe von 2 besitzt. 

- Breite und Höhe geben die Dimensionen der BitMap in Pixels an. Das 
BitMap muß mindestens so groß sein, wie das Window maximal sein 
kann. 

Anschließend muß noch der Speicherplatz für das BitMap belegt werden. 
Dies geschieht mit dem Befehl AllocRaster(Breite,Höhe). Die Parameter 
Breite und Höhe haben die gleiche Bedeutung wie bei InitBitMap. 

Das Ganze sieht also folgendermaßen aus: 

struct BitMap BM; 


main() 

{ 

INT i: 

InitBitMap(&BM.2,640,200); 
for (1 - 0;i < 2; 1++) 

lf((BM.Planestl]-AllocRaster(640,200))«=0) exit(); 
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Die exit() Anweisung beendet das Programm, falls nicht genügend Speicher¬ 
platz für die BitMaps vorhanden ist. 

Anschließend muß in der NewWindow-Structure noch der BitMap-Zeiger 
&BM gesetzt werden. 

Backdrop-Window: 

Dieses Window hat die gleichen Funktionen wie ein normales Window. Die 
Ausnahme besteht lediglich darin, daß dieses Window* nicht vor ein anderes 
gelegt werden kann. Das heißt, es erscheint hinter allen anderen Windows, 
was besonders für "Hintergrund-Informationen" brauchbar ist. 
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3.2 Window-Refreshing 

Intuition stellt dem Programmierer vier Möglichkeiten für das Erneuern sei¬ 
nes Windows zur Verfügung: 

- NOCAREREFRESH bedeutet, daß das Window nicht erneuert zu wer¬ 
den braucht. Dies ist die einfachste Möglichkeit. 

- SIMPLEREFRESH bedeutet, daß Intuition dem Programm über 
IDCMP mitteilt, daß das Window erneuert werden muß. Anschließend 
muß Intuition mit BeginRefresh in den Refresh-Zustand versetzt wer¬ 
den. Nun muß das Window vom Programm aus erneuert werden. Zum 
Schluß muß Intuition mit EndRefresh wieder zurückgesetzt werden. Der 
Vorteil dieser Methode ist, daß kein zusätzlicher Speicherplatz ver¬ 
wendet wird. Ein Beispiel für diese Methode ist der Editor »ed«. 

- SMARTREFRESH reserviert für den momentan sichtbaren Bereich des 
Windows Speicherbereich und kopiert dort diesen Teil hinein. Wenn das 
Window zwischenzeitlich von einem anderen Window überlappt wird, 
kann es im nachhinein wieder restauriert werden, wenn das andere 
Window »beiseite geschoben« wird. Allerdings kann immer nur der be¬ 
treffende Ausschnitt erneuert werden. Das heißt, wird das Window ver¬ 
größert, können die zuvor nicht sichtbaren Teile nicht restauriert wer¬ 
den. Der Vorteil dieser Methode ist das optimale Speicher¬ 
platz/Aufwand-Verhältnis. 

Wenn das Window vergrößert wurde, übermittelt Intuition über IDCMP 
dem Programm die Nachricht, die verbleibenden Bereiche selbst zu er¬ 
neuern. 

- SUPERBITMAP wurde schon oben erläutert. Der Vorteil dieser 
Methode ist, daß das gesamte Window erneuert wird, also auch die 
Teile, die vor dem Vergrößern des Windows nicht sichtbar waren. Der 
Nachteil liegt aber auf der Hand. Es ist der immense Speicherplatz¬ 
bedarf. 
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3.3 Die Window-Gadgets 

Der Programmierer kann für sein Window einige Funktionen direkt vom 
Intuition steuern lassen. Die Steuerung diese Funktionen erfolgen über 
Systemgadgets. 

Folgende Systemgadgets stellt Intuition zur Verfügung: 

1. WINDOWDRAG: Dieses Gadget ist der Balken am oberen Rand des 
Windows, der es erlaubt, das Window zu verschieben. 

2. WINDOWDEPTH: stellt die zwei Gadgets dar, mit Hilfe derer das 
Window in den Bildhintergrund, bzw. Bildvordergrund "gerückt" werden 
kann. 

3. WINDOWSIZE: Dieses Gadget ermöglicht die Veränderung der 
Windowgröße. 

4. WINDOWCLOSE: Dies ist das einzige Systemgadget, das vom Pro¬ 
gramm aus abgefragt werden muß, da Intuition das Window nicht selbst 
schließen kann. 

Welche Gadgets verwendet werden sollen, kann der Programmierer frei 
wählen. 

Selbstverständlich kann der Programmierer auch eigene Gadgets "installie¬ 
ren", die er aber auch selbst abfragen muß, wobei Intuition ihn aber hilfreich 
unterstützt. 
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3.4 IDCMP 


Zuvor wurde schon einige Male von IDCMP gesprochen. Nun wollen wir 
erläutern, wie IDCMP funktioniert. IDCMP heißt Intuition Direct 
Communication Message Port. 

Ob das Close-Gadget, ein eigenes Gadget oder ein Pull-Down-Menü betätigt 
wurde, kann das Programm nur von Intuition erfahren. Intuition teilt solche 
Meldungen über IDCMP dem Programm mit. Das Programm muß diese 
Meldungen annehmen und beantworten. Erst dann kann die Meldung be¬ 
arbeitet werden. 

main() 

{ 


FOREVER 

{ 

Wait(1<<HlndovPtr->UserPort->mp_SlgBit); /»Harten auf Meldung 

von Intuition*/ 

vhile (message - GetMsg(UlndovPtr->UserPort)) 

{ 

dass = message->Class; /«Meldung halten*/ 

ReplyMsg(nessage); /«Meldung bestätigen*/ 

lf(dass“CLOSEHINDOU) exlt(); /«Meldung interpretieren*/ 

I 


) 
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3.5 Die Window-Befehle 

Intuition stellt dem Programmierer eine Vielzahl leistungsfähiger Befehle zur 
Verfügung. So kann der Programmierer sämtliche Einstellungen des 
Windows, die er beim Öffnen des Windows angegeben hat jederzeit modi¬ 
fizieren. 

Er kann einem Window nachträglich das »WINDOWCLOSE«-Gadget 
»anhängen« oder aber den Window-Titel ändern. 

Zudem kann der Programmierer zu jeder Zeit die Funktion eines System- 
Gadgets nachahmen, wie zum Beispiel die Größenveränderung mittels 
»SizeWindow«. 

Um ein Window öffnen zu können, muß zuvor eine NewWindow-Structure 
initialisiert werden. Diese sieht folgendermaßen aus: 

struct NevWindov 

{ 

SHORT LeftEdge, TopEdge; 

SHORT Hidth, Height; 

UBYTE DetailPen, BlockPenj 
ULONG IDCMPFlags; 

ULONG Flags; 

struct Gadget »FirstGadget; 
struct Image »CheckMark; 

UBYTE »Title; 
struct Screen »Screen; 
struct BitMap »BitMap; 

SHORT MinWldth, MinHeight; 

SHORT MaxWidth, MaxHeight; 

USHORT Type; 

>; 

Beispiele für die Anwendung finden Sie in einigen Demonstrationen dieses 
Buches. 

Die Parameter im Einzelnen: 

LeftEdge ein ganzzahliger Wert zwischen 0 und 639, bzw. 319. 

TopEdge ein ganzzahliger Wert zwischen 0 und 511, bzw. 255. 

Width ein ganzzahliger Wert zwischen 0 und 639, bzw. 319. 

Height ein ganzzahliger Wert zwischen 0 und 511, bzw. 255. 

DetailPen Farbregister für Detail-Zeichnungen. 

BlockPen Farbregister für Flächenzeichnungen. 


Linke, obere Ecke 

Breite und Höhe 

Farben für Gadgets und Rand 

Intuition-Heldungen 

SystemGadgets/Refreshing usu. 

Zeiger auf erstes eigenes Gadget 

Zeiger auf Image für Menüs 

Window-Titel 

Zeiger auf Screen 

BltMap-Zeiger für SUPERBITMAP 

Kleinste Breite/Höhe für Window 

Größte Breite/Höhe für Window 

Screen-Typ 
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IDCMPFlags Hier wird festgesetzt, welche Meldungen von Intuition an das 
Programm übergeben werden sollen. Folgende Meldungen 
können übergeben werden. (In der structure müssen sie groß 
geschrieben werden!): 


Requerify, 

Reqclear, 

Reqset, 

Menuverify, 

Sizeverify, 

Newsize 


Refresh¬ 

window 


Mousebuttons 


Mousemove 


Gadgetdown 


Gadgetup 

Menupick 


Closewindow 


Meldung, nach einer Größen¬ 
veränderung des Windows 


Meldung, ob Window erneuert werden 
muß 

Meldung, ob Maustasten betätigt wor¬ 
den sind 

Funktioniert nur mit dem Flag 
REPORTMOUSE und übergibt Mel¬ 
dungen, wenn die Maus bewegt wurde. 

Meldung, ob Gadget gedrückt worden 
ist 

Meldung, ob Gadget gedrückt und 
wieder losgelassen wurde 

Übergibt die Meldung, welches Menü 
angewählt wurde 

Meldung, daß das Close-Gadget betä¬ 
tigt wurde 


Rawkey, Vanillakey, 

Intuiticks, 

Activewindow - Meldung, ob Window aktiv ist 

Inactivewindow - Meldung, ob Window inaktiv ist 

Nur die wichtigen Flags sind erklärt worden! 

Flags: Hier können die verschiedenen Window-Modi eingestellt 

werden. Folgende Modi stehen zur Verfügung: 

Windowsizing - Systemgadget zum Vergrößern 
/Verkleinern von Windows 
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FirstGadget: 

CheckMark: 

Title: 

Screen: 


Sizebright 

Sizebbottom 

Windowdepth 

Windowclose 

Windowdrag 

Nocarerefresh 

Simplerefresh 

Smartrefresh 

Superbitmap 

Gimmezero- 

zero 

Backdrop 

Borderless 

Reportmouse 


Activate 

Rmbtrap 


Das Gadget wird an der rechten Seite 
»angebracht« (Normalstellung) 

Das Gadget wird an der unteren Seite 
»angebracht« (Volle 80 Zeichen) 

Das Window kann in den Hintergrund 
»geklickt« werden 

Gadget zum Schließen des Windows 

Zum Verschieben des Windows 

Kein Erneuern des Windows 

Refresh-Typ 

Refresh-Typ 

RefreshTyp 


Window-Typ 

Window-Typ 

Window-Typ 

Informiert über die Mausposition rela¬ 
tiv zur linken oberen Ecke des 
Windows 

Das Window wird nach dem Öffnen 
aktiviert 

Setzt die normale Menüsteuerung 
außer Kraft, sondern steuert sie über 
die Maustasten 


Zeiger auf die Gadget-Structure des ersten User-Gadgets. 
Falls kein eigenes Gadget verwendet wird, wird dieser Para¬ 
meter gleich NULL gesetzt 

Zeiger auf ein Image für ein User-Häkchen bei Menüs. 
NULL, wenn das Standard-Häkchen verwendet werden soll. 


Windowtitel. Falls kein Titel gewünscht wird, muß hier 
NULL eingesetzt werden 

Wenn ein eigener Screen verwendet wird, also Type gleich 
CUSTOMSCREEN gesetzt wird, muß hier der Zeiger auf die 
Screen-Structure stehen, ansonsten NULL 
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BitMap: Zeiger auf ein BitMap-Structure, wenn ein SUPERBITMAP- 

Window verwendet wird, ansonsten NULL 

MinWidth: Minimale Window-Breite 

MinHeight: Minimale Window-Höhe 

MaxWidth: Maximale Window-Breite 

MaxHeight: Maximale Window-Höhe 

Type: Screen-Typ: WBENCHSCREEN oder CUSTOMSCREEN 

ScreenTypel bis 3 sind Intuition-spezifische Screens 

Diese Structure sieht sehr aufwendig aus, doch wenn man sich die Demon¬ 
strationen genau ansieht, sollte doch das meiste klar werden. Die Feinheiten 
werden sowieso erst bei größerer Programmiererfahrung erkennbar. 

Nach dem Öffnen eines Windows wird die Window-Structure zurückgegeben, 
die für die Anwendung der Window-Befehle überaus wichtig ist. Diese 
Structure führen wir hier nicht ausführlich auf, da ihr Aufbau nicht von 
größerer Bedeutung ist. Sie beinhaltet folgende zusätzliche Informationen: 

- WScreen: Zeiger auf die Structure des zugehörigen Screens 

- RPort: Zeiger auf den RastPort des Windows. Dieser Zeiger ist beson¬ 
ders für Textbefehle wichtig 

Zugreifen kann man auf diese Daten folgendermaßen: 

UindovPtr->UScreenund WindovPtr->RPort 

Nun aber zu den Window-Befehlen: 

3.5.1 ActivateWindow 

Syntax: ActivateWindow(WindowPtr); 

Funktion: Aktiviert ein Window 

Parameter: WindowPtr -> Zeiger auf die Window-Structure des 

Windows, das aktiviert werden soll 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *WindowPtr; 

Sonstiges: Das Window kann zu Beginn, also gleich nach dem Öffnen 

aktiviert werden, indem das ACTIVATE-Flag in der 
NewWindow-Structure gesetzt wird. 
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Referenz: Siehe auch die Flags der NewWindow-Structure. 

3.5.2 BeginRefresh 

Syntax: BeginRefresh(WindowPtr); 

Funktion: Diese Routine setzt Intuition und die Layer-Libraryin einen 

»Refresh-Zustand«. Wenn der Programmierer sein Window 
nun Stück für Stück erneuert, ignoriert, Intuition sämtliche 
Befehle, die sich auf Bereiche außerhalb des Windows bezie¬ 
hen. Dadurch wird eine enorme Effizienz erzielt. 

Parameter: WindowPtr -> Dieser Pointer zeigt auf das Window- 

Structure des Windows, das erneuert 
werden soll. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *WindowPtr; 

Sonstiges: Besonders effizient läßt sich ein Window erneuern, wenn man 

es zuvor als »SIMPLE_REFRESH«-Window geöffnet hat. Ist 
das Window teilweise zerstört, beispielsweise durch zeitweise 
Überlagerung eines anderen Windows, so erhält das Pro¬ 
gramm von Intuition die Meldung, das Window zu erneuern 
(»refreshen«). Nun gibt das Programm den Befehl 
»BeginRefresh(..)« und beginnt den Inhalt des Windows selb¬ 
ständig zu erneuern. Anschließend muß noch der Befehl 
»EndRefresh« gegeben werden, um Intuition wieder in den 
Normal-Modus zurückzusetzen. 

Diese Refresh-Methode ist besonders bei Windows empfeh¬ 
lenswert, die Texte enthalten, die das Programm gespeichert 
hat. Würde man für solch eine Anwendung ein 
SUPER BITMAP WINDOW öffnen, wäre dies eine un¬ 
nötige Speicherplatzverschwendung. 

Referenz: Siehe auch EndRefresh. 

3.5.3 ClearPointer 

Syntax: ClearPointer( WindowPtr); 

Funktion: Löscht den selbst definierten Mauszeiger. 

Parameter: WindowPtr -> Dieser Pointer zeigt auf das Window- 

Structure des Windows, dessen Maus¬ 
zeiger gelöscht werden soll. 
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Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *WindowPtr;Sonstiges: Mit dem Befehl 

»SetPointer« kann jedem Window ein eigener Mauszeiger 
zugewiesen werden, der immer dann sichtbar wird, wenn das 
betreffende Window aktiv, das heißt »angeklickt« ist. Dieser 
Zeiger kann mit dem Befehl »ClearPointer« wieder gelöscht 
werden. Dann ist wieder der normale Intuition-Zeiger -Pfeil¬ 
sichtbar. 

Referenz: Siehe auch SetPointer. 

3.5.4 CloseWindow 

Syntax: CloseWindow(WindowPtr); 

Funktion: Schließt ein Window, das zuvor mit OpenWindow geöffnet 

worden ist. 

Parameter: WindowPtr -> Dieser Pointer zeigt auf das Window- 

Structure des Windows, das geschlos¬ 
sen werden soll. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *WindowPtr; 

Sonstiges: Dieser Befehl schließt das betreffende Window und gibt den 

Speicherplatz frei. 

Der Programmierer muß dabei jedoch beachten, daß er zuvor 
alle Menüs, die er für dieses Window erstellt hat, mit 
»ClearMenuStrip« löscht, da Intuition ansonsten eventuell 
»abstürzt«! 

Zudem müssen alle Anfragen von Intuition über IDCMP mit 
»Reply« beantwortet worden sein, falls man einen IDCMP 
geöffnet hat. Ist dies nicht der Fall, übergeht Intuition alle 
Meldungen, die in Folge auftreten. 

Siehe auch OpenWindow. 


Referenz: 
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3.5.5 EndRefresh 

Syntax: 

EndRefresh(WindowPtr,Voll); 

Funktion: 

Diese Routine setzt Intuition und die Layer-Libraryvom 
»Refresh-Zustand« zurück in den Normal-Modus. Der 
»Refresh-Zustand« muß zuvor mit »BeginRefresh« ein¬ 
gestellt worden sein. 

Parameter: 

WindowPtr -> Dieser Pointer zeigt auf das Window- 

Structure des Windows, das erneuert 
worden ist. 


Voll -> enthält nach dem Aufruf einen Wahr¬ 

heitswert, TRUE oder FALSE. Ist der 
Wert TRUE, so wurde das Window 
vollständig erneuert, ist er FALSE, ist 
das Window nicht komplett erneuert 
worden. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct Window *WindowPtr; 
bool Voll; 

Sonstiges: 

Besonders effizient läßt sich ein Window erneuern, wenn man 
es zuvor als »SIMPLE REFRESH«-Window geöffnet hat. Ist 
das Window teilweise zerstört, beispielsweise durch zeitweise 
Überlagerung eines anderen Windows, so erhält das Pro¬ 
gramm von Intuition die Meldung, das Window zu erneuern 
(»refreshen«). Nun gibt das Programm den Befehl 
»BeginRefresh(..)« und beginnt den Inhalt des Windows selb¬ 
ständig zu erneuern. Anschließend muß der Befehl 
»EndRefresh« gegeben werden, um Intuition wieder in den 
Normal-Modus zurückzusetzen. 

Referenz: 

Siehe auch BeginRefresh. 




Die Window-Befehle 79 


3.5.6 ModifylDCMP 

Syntax: ModifyIDCMP(WindowPtr,IDCMPFlags); 

Funktion: Dieser Befehl ändert den Zustand des Window-IDCMP. 


Parameter: WindowPtr -> Dieser Pointer zeigt auf das Window- 

Structure des Windows, dessen Infor¬ 
mationsport zum Intuition aktualisiert 
werden soll. 

IDCMPFlags -> gibt den neuen Zustand des IDCMP 
an. 


Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *WindowPtr; 

WORD IDCMPFlags; 

Sonstiges: Über IDCMP -Intuition Direct Communication Message 

Port- kommunizieren Intuition und Programm. So teilt 
Intuition dem Programm über IDCMP beispielsweise mit, 
daß das WINDOWCLOSE-Gadget betätigt wurde. Dies 
allerdings nur, wenn zuvor das IDCMP-Flag 
CLOSEWINDOW gesetzt wurde. Soll nun ein eigenes, 
nachträglich mit »AddGadget« eingefügtes, Gadget abgefragt 
werden, so muß dies ebenfalls über IDCMP geschehen. Dazu 
muß Intuition allerdings mitgeteilt werden, daß es auch diese 
Information übermitteln soll. Hier wird nun der Befehl 
»ModifylDCMP« verwendet. In unserem Beispiel folgender¬ 
maßen: 


HodlfyIDCMP(HlndovPtr,GADGETUPIGADGETDOWN); 


Dem Programm wird nun mitgeteilt, ob ein Gadget betätigt 
wurde. 

Referenz: Für die IDCMPFlags siehe auch unter Kap. 3 das Window 
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3.5.7 MoveWindow 


Syntax: 

MoveWindow(WindowPtr,dx,dy); 

Funktion: 

Verschiebt ein Window um eine bestimmte Anzahl von 
Punkten. 

Parameter: 

WindowPtr -> Dieser Pointer zeigt auf das Window- 

Structure des Windows, das verschoben 
werden soll. 


dx -> gibt an, um wieviele Punkte das 

Window nach rechts oder links ver¬ 
schoben werden soll. Ist dx > 0, wird 
daß Window nach rechts verschoben. 


dy -> gibt an, um wieviele Punkte das 

Window nach oben oder unten ver¬ 
schoben werden soll. Ist dy > 0, wird 
daß Window nach unten verschoben. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct Window *WindowPtr; 

BYTE dx, dy; 

Sonstiges: 

Sollten dx oder dy zu groß oder zu klein gewählt worden sein, 
wird das Window so weit wie möglich verschoben. 

Referenz: 

Siehe auch SizeWindow 

WindowToFront 

WindowToBack 


3.5.8 OpenWindow 


Syntax: 

Window = OpenWindow(NewWindow); 


Funktion: 

Öffnet ein Window mit den Werten, die in der NewWindow- 
Structure enthalten sind und gibt den Zeiger auf das Window- 
Structure zurück. 

Parameter: 

NewWindow -> ist die NewWindow-Structure, die 

übergeben werden muß. Zuvor muß sie 
allerdings initialisiert worden sein. 

Ergebnis: 

Window -> Zeiger auf die Window-Structure 

geöffneten Windows. 

des 

Datentyp: 

struct NewWindow NewWindow; 



struct Window *Window; 
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Sonstiges: Nachdem das Window geöffnet worden ist, kann die 

NewWindow-Structure für weitere Windows verwendet wer¬ 
den, da sie nicht mehr von Bedeutung ist. 

Der Zeiger auf die neue Window-Structure muß allerdings 
übernommen werden, da er noch benötigt wird. Dazu ein 
Beispiel: 

struct Uindov ovnvlndov; 

struct NevUlndov nv - 
{ .. )i 

naln() 

{.. 

ovnvlndov - OpenWindov(nv); 

..) 

Referenz: Für den Aufbau der NewWindow- und der Window-Structure 

siehe unter Kap. 3 "Das Window". 


3.5.9 


RefreshWindowFrame 


Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 


RefreshWindowFrame(WindowPtr); 

erneuert die Umrandung des spezifizierten Windows 

WindowPtr -> Zeiger auf die Window-Structure des 
Windows, dessen Umrandung erneuert 
werden soll. 

Kein Ergebnis. 

struct Window *WindowPtr; 

Im Normalfall muß dieser Befehl nicht gegeben werden, da 
Intuition dies von selbst handhabt. 

Siehe auch RefreshDisplay 
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3.5.10 ReportMouse 

Syntax: ReportMouse(WindowPtr, Status); 

Funktion: Dieser Befehl setzt das »REPORTMOUSE«-Flag in der 

Window-Structure, bzw. setzt es zurück. Ist es gesetzt, wird 
das Programm bei aktiviertem Window ständig von Intuition 
über die Position der Maus informiert. 

Parameter: WindowPtr -> Dieser Pointer zeigt auf die Window- 

Structure des Windows, der die Maus- 
Informationen übergeben werden sol¬ 
len. 

Status -> ist ein Wahrheitswert. Wird TRUE an¬ 

gegeben, wird die Funktion ein¬ 
geschaltet. FALSE schaltet sie aus. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *WindowPtr; 

bool Status; 

Sonstiges: Wird dieser Befehl verwendet, wenn zur gleichen Zeit ein 

Gadget vom Benutzer aktiviert, das heißt »angeklickt« ist, 
bleibt er nur so lange aktiv, bis das Gadget deaktiviert wird. 
Dies ist besonders bei Gadgets wichtig, die mit der Maus ver¬ 
schoben werden können, wie zum Beispiel das SIZE-Gadget. 
Damit kann das Programm ständig die Gadget-Bewegungen 
nachvollziehen. 

Referenz: Siehe auch die Flags der NewWindow-Structure 

3.5.11 SetPointer 

Syntax: SetPointer(WindowPtr,&Data[0],Höhe,Breite,X,Y); 

Funktion: Setzt einen Window-spezifischen Mauszeiger. 

Parameter: WindowPtr -> Dieser Pointer zeigt auf die Window- 

Structure des Windows, das einen spe¬ 
ziellen Mauszeiger erhalten soll. 

&Data[0] -> ist ein Zeiger auf die Sprite-Daten für 

den neuen Zeiger. 

-> gibt die Höhe des Zeigers in Punkten 
an. 


Höhe 
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Breite -> gibt die Breite des Zeigers in Punkten 

an. Maximal darf das Sprite 16 Punkte 
breit sein. 

X,Y -> geben die relative Koordinate des 

Aktiv-Punktes an. Die Koordinate muß 
relativ zur linken, oberen Ecke des 
Sprites angegeben werden, wobei 
darauf zu achten ist, daß die Koordi¬ 
naten negativ einzugeben sind! 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *WindowPtr; 

USHORT Data[]; 
int Höhe, Breite, X, Y; 

Sonstiges: Der normale Mauszeiger -der Pfeil- wechselt immer dann 

in den selbst definierten, wenn das spezifizierte Window aktiv 
ist. Sobald es deaktiviert ist, wird wieder der normale Maus¬ 
zeiger sichtbar. 

Der Aktiv-Punkt gibt die Stelle des Zeigers an, mit der der 
Benutzer über einem Gadget o.ä. sein muß, wenn er es 
»betätigen« will. 

Für X und Y können auch positive Zahlen eingegeben wer¬ 
den, was aber nicht sehr sinnvoll ist, da der Aktiv-Punkt dann 
außerhalb des Sprites, bzw. des Zeigers liegt. Dies ist auch 
der Fall, falls X kleiner als -15 ist, oder Y kleiner als das 
Negat von der Zeigerhöhe. 

Beispiel für die Deklaration: 


USHORT datah » 

{ 

0x0000 0x0000 /* Start-Bytes müssen lmmer0 sein*/ 

0XFFFF 0XFFFF 0xF00F 0xF00F 0xF00F 0xF00F 0xF00F 0xF00F 
0XF00F 0XF00F 0XF00F 0xF00F 0xF00F 0xF00F 0xFFFF 0XFFFF 

0x0000 0x0000 /* End-Bytes müssen immer 0 sein*/ 

}; 


main() 
{ 
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SetPolnter(UlndovPtr,&data[0],16,16,-7,-7); 


Referenz: Siehe auch ClearPointer und Kapitel 5.3 Animation mit 

SetPointer 


3.5.12 SetWindowTitles 


Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 


Sonstiges: 


Referenz: 


SetWindowTitles(WindowPtr,&WTitel{0],&STitel[0]); 

Gibt dem Window einen neuen Namen und setzt einen 
Window-spezifischen Screen-Titel. 

WindowPtr -> Dieser Pointer zeigt auf die Window- 
Structure des Windows, dessen Titel 
geändert werden sollen. 

&WTitel[0] - > Zeiger auf einen neuen Window-Titel. 

&STitel[0] - > Zeiger auf einen neuen Screen-Titel. 

Kein Ergebnis. 

struct Window *WindowPtr; 
char WTitel[]; 
char STiteI[J; 

Dieser Befehl setzt einen neuen Window-Titel, der immer in 
der Window-Titelzeile erscheint. Mit diesem Befehl kann 
auch der spezielle Screen-Titel geändert werden, der immer 
dann erscheint, wenn das Window aktiv ist. 

Für WTitel und STitel können auch die Werte -1 und 0 ein¬ 
gesetzt werden. 

-1 bewirkt keine Änderung des betreffenden Titels, der alte 
Titel bleibt erhalten. Dies ist dann zu verwenden, wenn nur 
einer der Titel geändert werden soll. 

0 bewirkt die Löschung des betreffenden Titels. 

Siehe auch unter Kap. 3 Das Window und unter Kap 2. 
ShowTitle. 
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3.5.13 

SizeWindow 


Syntax: 

SizeWindow(WindowPtr,dx,dy); 


Funktion: 

Modifiziert die Größe eines Windows. 


Parameter: 

WindowPtr -> Dieser Pointer zeigt auf die Window- 

Structure des Windows, das modifiziert 
werden soll. 



dx -> gibt an, um wieviele Punkte das 

Window in X-Richtung vergrößert oder 
verkleinert werden soll. 



dy -> gibt an, um wieviele Punkte das 

Window in Y-Richtung vergrößert oder 
verkleinert werden soll. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Window *WindowPtr; 
int dx, dy; 


Sonstiges: 

Für dx und für dy < 0 wird das Window verkleinert. 



Überaus wichtig ist, daß Intuition nicht überprüft, ob die 
Werte zulässig sind. Das heißt, wenn das Window auf 1000 x 
1000 Punkte vergrößert wurde, erhält man sehr unschöne 
Ergebnisse. 


Referenz: 

Siehe auch MoveWindow 

WindowT oFront 

WindowToBack 

3.5.14 

ViewPortAddress 


Syntax: 

vp = ViewPortAddress(WindowPtr); 
oder 

if (ViewPortAddress(WindowPtr) = = 34565) 
usw. 


Funktion: 

Ermittelt die Adresse des ViewPorts des spezifizierten 
Windows. 


Parameter: 

WindowPtr -> Dieser Pointer zeigt auf die Window- 

Structure des Windows, dessen 
ViewPort-Addresse ermittelt werden 
soll. 
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Ergebnis: 

vp 

-> Adresse des ViewPorts, auf dem das 
Window erscheint. 

Datentyp: 

struct Window 
ULONG vp; 

*WindowPtr; 

Sonstiges: 

Dieser Befehl wird äußerst selten benötigt, da meist der Zei¬ 
ger auf den RastPort des Windows ausreicht. Sollte eine 
Funktion benutzt werden, die den ViewPort des Screens, auf 
dem sich das Window befindet, benötigt, kann dieser Befehl 
verwendet werden. 

Referenz: 

Für Informationen über View- und Rastport siehe auch 
Kapitel 2 »Der Screen«. 

3.5.15 WindowLimits 


Syntax: 

ok = WindowLimits(WindowPtr,MinX f MinY,MaxX,MaxY); 
oder 

if(WindowLimits(WindowPtr,MinX,MinY,MaxX,MaxY) = = 

FALSE) 

usw. 

Funktion: 

Setzt die Größenbeschränkungen eines Windows neu. 

Parameter: 

WindowPtr 

-> Dieser Pointer zeigt auf die Window- 
Structure des Windows, dessen 
Größenbeschränkungen neu gesetzt 
werden sollen. 


MinX 

- > setzt die Minimalgröße des Windows in 
X-Richtung. 


MinY 

- > setzt die Minimalgröße des Windows in 
Y-Richtung. 


MaxX 

-> setzt die Maximalgröße des Windows 
in X-Richtung. 


MaxY 

-> setzt die Maximalgröße des Windows 
in Y-Richtung. 

Ergebnis: 

ok 

-> Gibt den Wahrheitswert TRUE zu¬ 
rück, falls alles in Ordnung war. Waren 
die Minimalwerte größer oder waren 
die Maximalwerte kleiner als die der¬ 
zeitige Größe des Windows, wird 
FALSE zurückgegeben. 
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Datentyp: struct Window *WindowPtr; 

int MinX, MinY, MaxX, MaxY; 
bool ok; 

Sonstiges: Als Wert kann auch 0 angegeben werden, was bewirkt, daß 

die entsprechende Größenbeschränkung nicht geändert wird, 
was verwendet wird, um nur einzelne Werte zu ändern. 

Ist ein einzelner Wert nicht mit der derzeitigen Windowgröße 
vereinbar, wird er ignoriert und es wird FALSE zurück¬ 
gegeben. Die anderen Werte werden trotzdem modifiziert. 

Referenz: Siehe auch OpenWindow 


3.5.16 WindowToBack 


Syntax: 

WindowToBack(WindowPtr); 

Funktion: 

Setzt ein Window hinter alle anderen Windows zurück. 

Parameter: 

WindowPtr -> Dieser Pointer zeigt auf die Window- 

Structure des Windows, das zurück¬ 
gesetzt werden soll. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct Window *WindowPtr; 

Sonstiges: 

Das spezifizierte Window wird durch diesen Befehl hinter alle 
anderen Windows zurückgesetzt. Allein die Backdrop- 
Windows bilden hier eine Ausnahme. Wendet man den 
Befehl auf ein solches Window an, geschieht nichts, da diese 
Windows schon zuhinterst sind und zudem nicht hervorgeholt 
werden können. 

Referenz: 

Für Backdrop-Windows siehe auch Kap. 3 »Das Window«. 
Siehe auch MoveWindow 

SizeWindow 

WindowToFront 


3.5.17 WindowToFront 

Syntax: WindowToFront(WindowPtr); 

Funktion: Setzt ein Window vor alle anderen Windows. 

Parameter: WindowPtr -> Dieser Pointer zeigt auf die Window- 

Structure des Windows, das hervor¬ 
geholt werden soll. 
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Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *WindowPtr; 

Sonstiges: Das spezifizierte Window wird durch diesen Befehl vor alle 

anderen Windows gesetzt. Allein die Backdrop-Windows bil¬ 
den hier eine Ausnahme. Wendet man den Befehl auf ein 
solches Window an, geschieht nichts, da diese Windows nicht 
hervorgeholt werden können. 

Referenz: Für Backdrop-Windows siehe auch Kap. 3 Das Window. 

Siehe auch MoveWindow 

SizeWindow 

WindowToBack 

1 /*************************#***** 

2 

3 Window-Demonstration 

4 last update 26/05/07 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt & Technik 1987 

7 

8 i ******************************** 

9 

10 Diese Demonstration zeigt die Anwendung der Windowbe-fehle 

11 

12 *******************************/ 

13 

14 #include <exec/types.h> /* Include-Files einladen */ 

15 #include <exec/nodes.h> 

16 #include <exec/lists.h> 

17 #include <exec/ports.h> 

18 #include <exec/devices.h> 

19 #include <devices/keymap.h> 

20 ttinclude <graphics/regions.h> 

21 #include <graphics/copper.h> 

22 #include <graphics/gels.h> 

23 #include <graphics/g-fxbase.h> 

24 #include <graphics/g-fx. h> 

25 #include <graphics/clip.h> 

26 #include <graphics/view.h> 

27 #include <graphics/rastport.h> 

28 #include <graphics/layers.h> 

29 #include <intuition/intuition.h> 

30 #include <hardware/blit.h> 

31 

32 struct IntuitionBase #IntuitionBase; /* Lib - Zeiger */ 


33 

struct 

G-fxBase *GfxBase; 




34 






35 

struct 

RastFtort #rp; 




16 

struct 

Window #nor, *bor, #bac: 




37 

struct 

IntuiMessage *message; 




38 






39 

struct 

NewWindow normal = 




40 

i 





41 

o, 

/* 

Linke 

Ecke 

#/ 

42 

10, 

/* 

Obere 

Ecke 

*/ 

43 

200, 

, /* 

Breite */ 


44 

100, 

, /* 

Hoehe 

*/ 
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45 3, /# DetailPen */ 

46 1, /* BlockPen */ 

47 CLOSEWINDOW!REFRESHWINDOW, /* IDCMP-Flags */ 

48 WINDOWCLOSE!WINDQWSI ZING: WINDOWDEPTHJ WINDOWDRAGINOCAREREFRESH, /% Flags #/ 

49 NULL, 

50 NULL, 

51 "Normal-Window", /* Window-Text */ 

52 NULL, 

53 NULL, 

54 20, 

55 20, 

56 640, 

57 256, 

58 WBENCHSCREEN /% Screen-Typ #/ 

59 >; 

60 

61 struct NewWindow backdrop = 

62 { 

63 220, 

64 80, 

65 200, 

66 100 , 

67 3, 

68 1 , 

69 CLOSEWINDOW; REFRESHWINDOW, 

70 NOCAREREFRESH I BACKDROP, 

71 NULL, 

72 NULL, 

73 "Backdrop-Window", 

74 NULL, 

75 NULL, 

76 0, 

77 0, 

78 0, 

79 0, 

80 WBENCHSCREEN 

81 }; 

82 

83 struct NewWindow borderless = 

84 { 

85 440, 

86 10 , 

87 200, 

88 100 , 

89 3, 

90 1, 

91 CLOSEWINDOW; REFRESHWINDOW, 

92 WINDOWSI ZING i WINDOWDEPTH! W1ND0WDRAG '■ NOCAREREFRESH i BORDERLESS, 

93 NULL, 

94 NULL, 

95 "Borderless-Windaw", 

96 NULL, 

97 NULL, 

98 20, 

99 20, 

100 640, 

101 256, 

102 WBENCHSCREEN 

103 >; 

104 

105 USHORT NormlmageC1 = 

106 { 


/* Spritelmage-Structure */ 
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109 

OxFFFE, 

0x8001, 

110 

0x8000, 

0x8001, 

111 

0x8000, 

0x8001, 

112 

0x8000, 

0x8001, 

113 

0x8000, 

0x8001, 

114 

0x8000, 

0x8001, 

115 

0x8000, 

0x8001, 

116 



117 

0,0 


118 

>; 


119 



120 

USHORT Bor Image! 1 - 

121 

< 


122 

0,0, 


123 



124 

0xC003, 

0x0000, 

125 

0xE007, 

0x0000, 

126 

0x700E, 

0x0000, 

127 

0x381C, 

0x0000, 

128 

0xlC38, 

0x0000, 

129 

OxOE70, 

0x0000, 

130 

0x07E0, 

0x0000, 

131 

0x03C0, 

0x0000, 

132 

0x03C0, 

0x0000, 

133 

0x07E0, 

0x0000, 

134 

0x0E70, 

0x0000, 

135 

Ox1C38, 

0x0000, 

136 

0x381C, 

0x0000, 

137 

0x700E, 

0x0000, 

138 

0xE007, 

0x0000, 

139 

0xC003, 

0x0000, 

140 



141 

0,0 


142 

>; 


143 



144 

USHORT BacImage:I : 

145 



146 

o 

o 


147 



148 

0x0000, 

0xC003, 

149 

0x0000, 

0xE007, 

150 

0x0000, 

0x700E, 

151 

0x0000, 

0x381C, 

152 

0x0000, 

0xlC38, 

153 

0x0000, 

0x0E70, 

154 

0x0000, 

0x07E0, 

155 

0x0000, 

0x03C0, 

156 

0x0000, 

0x03C0, 

157 

0x0000, 

0x07E0, 

158 

0x0000, 

0x0E70, 

159 

0x0000, 

0xlC38, 

160 

0x0000, 

0x381C, 

161 

0x0000, 

0x700E, 

162 

0x0000, 

, OxE007, 

163 

0x0000, 

, 0xC003, 

164 



165 

0,0 


166 

>; 


167 



168 

main() 


169 

i 


170 

ULONG MessageCla 

171 

USHORT code; 

172 

LONB warte; 


/% Spritelmage-Structure */ 


/% Spritelmage-Structure */ 
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173 

174 i-f<! (GfxBase = (struct GfxBase *)OpenLibrary("graphics.library“,0))) 

175 { 

176 c 1 ose_things (); 

177 exit(); /# oeffnen der Libraries %/ 

178 > 

179 

180 i-f ( ! (IntuiticnBase = (struct IntuitionBase #) 

181 OpenLibrary("intuition.library",0))) 

182 { 

183 close_things(); 

184 exitO; 

185 > 

186 

187 i-f (!(bor = (struct Window *)OpenWindow(&borderless) )) 

188 { 

189 close_things(); /* oeffnen der Windows #/ 

190 exit(); 

191 > 

192 

193 i-f (!(bac = (struct Window * )OpenWindow(&backdrop) )) 

194 { 

195 close_things(); 

196 exitO; 

197 > 

198 

199 i-f ( ! (nor = (struct Window % )üpenWindow(Anormal) )) 

200 { 

201 close_things(); 

202 exitO; 

203 > 

204 

205 SetPointer(nor,&NormImageC03,7,16,-7,-4); /* Setzen des Mauszeigers */ 

206 SetWindowTitles(nor,-l, /* Window-Titel setzen %/ 

207 "Dies ist der Screen-Titel fCr das normale Window“); 

208 

209 SetPointer(bor,&BorImageC03,16,16,-7,-7); 

210 SetWindowTitles(bor,-l, 

211 "Dies ist der Screen-Titel -fCr das Borderless-Window"); 

212 

213 SetPointer(bac,&BacImageCOD,16,16,-7,-7); 

214 SetWindowTitles(bac,-l, 

215 "Dies ist der Screen-Titel fCr das Backdrop-Window"); 

216 

217 rp = nor->RPort; 

218 /# Window verschieben */ 

219 MoveWindow(nor,180,40); 

220 

221 SizeWindow(nor,50,50); /* Window vergroessern */ 

222 

223 -for(warte = 0; warte < 100000; warte++); 

224 

225 SizeWindow(nor,-50,-50); 

226 

227 MoveWindow(bor,-180,120); 

228 

229 -for(warte = 0; warte < 10; warte++) 

230 { 

231 WindowToFront(nor); 

232 WindowToFront(bor); /* Window nach vorn #/ 

233 ); 

234 

235 -for (;;) 
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236 { 

237 i-f (message = (struct IntuiMessage *)GetMsg(nor->UserPort)) 

238 < /# auf Message von Intuition warten */ 

239 MessageClass = message->Class; /* Message retten */ 

240 Code = message->Code; 

241 ReplyMsg(message); 

242 i-f (MessageClass = CLOSEWINDGW) (close_things(>; exit();>; 

243 >; /* wenn Window geschlossen wjrde -> Ende */ 

244 > 

245 > 

246 

247 close_things() 

248 < 

249 C1oseWindow < nor); 

250 C1oseWindow(bac); 

251 C1oseWindow(bor); 

252 CloseLibrary(GfxBase); 

253 C1oseLlbrary(IntuitionBase); 

254 > 


/* Unterroutine zum Sch1 1 essen #/ 
/% Windows und Libs schliessen #/ 
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Zeichnen in Screens und 

Windows 


In diesem Kapitel wollen wir die einfachen Zeichenbefehle behandeln, die 
der Amiga zur Verfügung stellt. Im Gegensatz zu einigen anderen Rechnern 
ist eine Vielzahl von Grafikbefehlen schon vorhanden, die nur noch auf¬ 
gerufen werden müssen. 

Aber auch Texte können mit einfachen Befehlen auf beliebige Screens oder 
Windows geschrieben werden. Dabei stehen selbstverständlich auch ver¬ 
schiedene Schriftarten bereit, die wiederum in vielen Varianten dargestellt 
und kombiniert werden können. 

Weitere einfache Grafikmöglichkeiten sind Images und Borders. Images sind 
beliebig große Grafiken, die an jeder Stelle des Screens plaziert werden kön¬ 
nen. So verwenden viele Gadgets, die eine bestimmte Form haben sollen, 
eigene Images. 

Borders sind eine Anzahl von Linien, die durch x,y-Koordinaten festgelegt 
sind. Wie der Name schon sagt, können damit Ränder gezeichnet werden, 
oder aber auch ganz andere Dinge, wie zum Beispiel Rechtecke oder Poly¬ 
gone. Für welche Aufgaben der Programmierer sie nutzt, bleibt ihm allein 
überlassen. 
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4.1 Einfache Zeichenbefehle 

Das der Amiga ein Grafiktalent ist, ist gemeinhin bekannt. Aber das diese 
Grafikmöglichkeiten einfach zu handhaben sind, ist bei weitem nicht so ver¬ 
breitet. 

Die Graphics-Bibliothek des Amiga stellt eine Vielzahl von Befehlen zur 
Verfügung, die bei vielen anderen Rechnern erst umständlich zu implemen¬ 
tieren oder gar nicht realisierbar sind. 

Zu der ersten Gruppe zählen die normalen Grafikbefehle, wie DrawCircle, 
DrawEllipse, Draw, Move usw. Diese Befehle sind von anderen Computern 
her bekannt. 

Zur zweiten Gruppe zählen die Area-Befehle. Die Area-Befehle erleichtern 
die Handhabung von gefüllten Flächen ungemein. So lassen sich gefüllte 
Kreise und Ellipsen mittels eines einzigen Befehls erzeugen. Und dies in 
enormer Geschwindigkeit. Aber auch gefüllte Polygone - Vielecke - lassen 
sich sehr einfach erstellen. Diese Polygone dürfen beliebig viele Eckpunke 
haben. 

Allein die Installierung der Areas erscheint umständlich, da ungewohnt: 

1. Mit AllocRaster muß Speicherbereich reserviert werden, der mindestens 
so groß sein muß, wie das größte, zu zeichnende Object. Im Zweifelsfall 
ist dies die Größe des Screens, auf den gezeichnet wird. 

2. Mit InitTmpRas muß ein Speicherbereich für die Verwendung durch 
Areas installiert werden. 

3. Mit InitArea wird angezeigt, daß Area-Befehle verwendet werden. 

4. Mit FreeRaster wird am Ende des Programms der belegte Speicherplatz 
wieder verfügbar gemacht. 

Nähere Informationen zu diesem Thema sind dem Demonstrations¬ 
programm zu entnehmen. 

4.1.1 AreaCircle 

Syntax: fehler = AreaCircle(rastport,x,y,radius); 

Funktion: Fügt eine Kreisinformation zur Area-Info-Liste hinzu. Das 

bedeutet, wenn alle Areas gezeichnet werden, wird auch die¬ 
ser Kreis gezeichnet und ausgefüllt. 
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Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

Screens oder Windows, in den der 
Kreis gezeichnet werden soll. 

x,y - > Koordinaten des Mittelpunktes. 

radius - > Radius des Kreises in Pixel. 


Ergebnis: 

fehler -> 0, falls erfolgreich, 1, falls nicht. 


Datentyp: 

struct RastPort "rastport; 
int x, y, radius; 
int fehler; 


Sonstiges: 

Der Kreis wird in der Farbe ausgefüllt, die für die momentan 
definierten Areas gilt. 


Referenz: 

Für Areas siehe InitArea 

4.1.2 

AreaDraw 


Syntax: 

fehler = AreaDraw(rastport,x,y); 


Funktion: 

Fügt einen Eckpunkt für ein Polygon an die Area-Liste ein. 


Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

Screens oder Windows, in den das 
Polygon gezeichnet werden soll. 

x,y -> Koordinaten des Eckpunktes. 


Ergebnis: 

fehler -> 0 bedeutet kein Fehler, -1 bedeutet, 

daß nicht genügend Speicherplatz für 
die Area-Liste reserviert wurde. 


Datentyp: 

struct RastPort *rastport; 
int x, y; 
int fehler; 


Sonstiges: 

Das Polygon kann so viele Eckpunkte haben, wie benötigt 
werden. Allerdings muß genügend Speicherplatz mit InitArea 
reserviert worden sein. 


Referenz: 

Für Areas siehe InitArea 

4.1.3 

AreaEIIipse 


Syntax: 

fehler = AreaEllipse(rastport,x,y,hradius,vradius); 


Funktion: 

Hängt eine Ellipse-Information an die Area-Liste an 
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Parameter: 

rastport -> Zeiger auf den RastPort des Screens 

oder Windows, in den die Ellipse ge¬ 
zeichnet werden soll. 

x,y - > Koordinaten des Mittelpunktes. 

hradius -> Radius auf der Horizontalen. 

vradius -> Radius auf den Vertikalen. 

Ergebnis: 

fehler -> 0 bedeutet keine Probleme, 1 bedeutet, 

daß kein Speicherplatz für die Ellipse- 
Information in der Area-Liste vor¬ 
handen ist. 

Datentyp: 

struct RastPort "rastport; 
int x, y, hradius, vradius; 
int fehler; 

Sonstiges: 

Die Ellipse wird beim Ausfuhren der Area-Informationen 
ausgefüllt. Die Farbe, in der das geschieht, ist allgemein für 
die Areas zuvor festgelegt worden. 

Referenz: 

Für Areas siehe InitArea 

4.1.4 AreaEnd 

* 

Syntax: 

AreaEnd(rastport); 

Funktion: 

Zeichnet die Kreise, Ellipsen und Polygone, die mit 
AreaCircle, AreaEllipse und AreaDraw deklariert worden 
sind. 

Parameter: 

rastport -> Zeiger auf den RastPort, für den die 

Area-Informationen deklariert worden 
sind. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct RastPort "“rastport; 

Sonstiges: 

Dieser Befehl schließt die Area-Deklaration ab und zeichnet 
alles in den RastPort. Anschließend löscht er die Area-Liste, 
so daß sie neu benutzt werden kann. 

Referenz: 

Für Areas siehe InitArea 
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4.1.5 

AreaMove 



Syntax: 

fehler = AreaMove(rastport,x,y); 


Funktion: 

Schließt das vorhergehende Polygon, das mit einer Anzahl 
AreaDraw-Befehlen deklariert worden ist,ab und definiert 
einen Startpunkt für das nächste Polygon. 


Parameter: 

rastport -> Zeiger auf den rastPort des Screens 

oder Windows, für den die Area-Liste 
gilt. 

x,y -> Koordinaten des Startpunktes für das 

neue Polygon. 


Ergebnis: 

fehler -> 0, falls erfolgreich, 1, falls nicht. 


Datentyp: 

struct RastPort *rastport; 
int x, y; 
int fehler; 


Sonstiges: 

Dieser Befehl braucht nicht benutzt zu werden, wenn die 
Area-Liste abgeschlossen wird. 


Referenz: 

Für Areas siehe InitArea 

4.1.6 

BNDRYOFF 


Syntax: 

BNDRYOFF(rastport); 


Funktion: 

Schaltet die Randüberschreitungs-Kontrolle bei Area-End 
und RectFill ab 


Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

Screens oder Windows, für die dieser 
Befehl Wirkung haben soll. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct RastPort *rastport; 


Sonstiges: 

Die Randüberschreitungskontrolle kontrolliert, ob beim 
Zeichnen mit RectFill oder bei den Area-Befehlen der Aus¬ 
schnitt, der vom RastPort beschrieben wird, überschritten 
wurde. Im Normalfall wird dieser Befehl nicht verwendet. 
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4.1.7 

Draw 



Syntax: 

Draw(rastport,x,y); 


Funktion: 

Zeichnet von der momentanen Stiftposition zur angegebenen 
Position. 


Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in den gezeichnet werden 
soll. 

x,y - > Koordinaten der neuen Stiftposition. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct RastPort *rastport; 
int x, y; 


Sonstiges: 

Dieser Befehl zeichnet in der Farbe, die mit SetAPen, 
SetBPen, SetOPen und SetDrMd eingestellt werden kann. 

4.1.8 

DrawCircle 


Syntax: 

DrawCircle(rastport,x,y,radius); 


Funktion: 

Zeichnet einen Kreis. 


Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in den gezeichnet werden 
soll. 

x,y -> Koordinaten des Mittelpunktes. 

radius - > Radius des Kreises in Pixel. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct RastPort *rastport; 
int x, y, radius; 


Sonstiges: 

Dieser Befehl zeichnet in der Farbe, die mit SetAPen, 
SetBPen, SetOPen und SetDrMd eingestellt werden kann. 
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4.1.9 

DrawEllipse 


Syntax: 

DrawEllipse(rastport,x,y,hradius,vradius); 


Funktion: 

Zeichnet eine Ellipse 


Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in den gezeichnet werden 
soll. 

x,y -> Koordinaten des Mittelpunktes. 

hradius -> Radius auf der horizontalen Achse. 

vradius -> Radius auf der vertikalen Achse. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct RastPort *rastport; 
int x, y, hradius, vradius; 


Sonstiges: 

Dieser Befehl zeichnet in der Farbe, die mit SetAPen, 
SetBPen, SetOPen und SetDrMd eingestellt werden kann. 

4.1.10 

Flood 



Syntax: 

Flood(rastport,mode,x,y); 


Funktion: 

Füllt einen Bereich aus. 


Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in dem ein Bereich aus¬ 
gefüllt werden soll. 

mode -> gibt den Füllmodus an. 

x,y -> Position, von der aus gefüllt werden 

soll. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct RastPort *rastport; 
int mode, x, y; 


Sonstiges: 

Ist mode gleich 1, wird der Bereich ausgefüllt, der die gleiche 
Farbe hat, wie der Punkt mit den Koordinaten x und y. 

Ist mode gleich 0, wird soweit gefüllt, bis die Funktion auf 
Punkte mit der Farbe trifft, die mit SetOPen gesetzt worden 
ist. 




100 Zeichnen in Screens und Windows 


Um Flood verwenden zu können, muß zuerst mit AIlocRaster 
und InitTmpRas, genau wie bei Areas, ein Speicherbereich 
für die Verwendung durch Flood, bzw. Area reserviert wer¬ 
den. 

4.1.11 GetRGB4 

Syntax: farbwert = GetRGB4(CMap,Nr); 

Funktion: Holt den Farbwert aus dem spezifizierten Farbregister 

Parameter: CMap -> Zeiger auf die ColorMap. 

Nr - > Farbregisternummer. 

Ergebnis: farbwert - > Farbwert des spezifizierten Registers. 

Datentyp: struct ColorMap *CMap; 

int Nr; 

WORD farbwert; 

Sonstiges: Auf die ColorMap kann folgendermaßen zugegriffen werden: 

ScreenPtr- > ViewPort- > ColorMap 

oder aber vom Window-Pointer aus: 

WindowPtr- > WScreen- > ViewPort- > ColorMap 

Der Farbwert kann hexadezimal am einfachsten ausgewertet 
werden. Er ist wie folgt aufgebaut: 

OxORGB (R = Rotwert; G = Grünwert; B = Blauwert) 

4.1.12 InitArea 

Syntax: InitArea(info,Speicher,maxein); 

Funktion: Initialisiert die Area-Liste. 

Parameter: info -> Zeiger auf die Arealnfo-Structure des 

zugehörigen RastPorts. 

Speicher -> Zeiger auf einen freien Speicher¬ 

bereich für die Area-Informationen. 

maxein -> Die maximale Anzahl von Koordina¬ 

teneinträgen in die Liste. 


Ergebnis: Kein Ergebnis. 
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Datentyp: struct Areainfo *info; 

ULONG Speicher; 
int maxein; 

Sonstiges: Auf die Areainfo kann folgendermaßen zugegriffen werden: 

Window:WindowPtr -> RPort->Areainfo 

Screen:ScreenPtr -> RastPort-> Areainfo 

Areas sind spezielle Grafikteile des Amiga. Mit ihrer Hilfe 
können überaus leicht ganze Listen von Grafikelementen auf¬ 
gebaut werden, die mittels AreaEnd auf einmal auf den Bild¬ 
schirm gezeichnet werden. Es gibt drei Grafikelemente, die 
bei Areas verwendet werden können: 

1. Kreise: Mittels AreaCircle können Kreise in die Area-Liste 
eingetragen werden, die beim Zeichnen ausgefüllt werden. 

2. Ellipsen: Ellipsen sind im Prinzip genauso zu behandeln, 
wie Kreise, nur daß sie mit AreaEllipse eingetragen werden. 

3. Polygone: Polygone sind die wohl am meisten verwendeten 
Grafikelemente bei Areas. Sie können aus beliebig vielen 
Eckpunkten bestehen, die mit AreaDraw in die Liste ein¬ 
getragen werden müssen. Soll ein Polygon abgeschlossen 
werden und ein neues begonnen werden, so muß der Befehl 
AreaMove verwendet werden. 

Als letztes wird dann der Befehl AreaEnd gegeben, der das 
Zeichnen der Grafikelemente veranlaßt. Anzumerken ist, 
daß alle Elemente ausgefüllt werden und zwar in der Farbe, 
die mit SetOPen gesetzt wird. 


4.1.13 InitTmpRas 

Syntax: InitTmpRas(tmpras, Speicher, große); 

Funktion: Reserviert Speicherplatz für die Verwendung durch Areas. 


Parameter: tmpras 

-> Zeiger auf die TmpRas-Structure. 

Speicher 

-> Ist der Zeiger, der durch diesen Befehl 
auf den Beginn des reservierten Spei¬ 
cherplatzes zeigt. 

große 

-> gibt die Größe des zu reservierenden 
Speicherplatzes an. 


Ergebnis: 


Kein Ergebnis. 
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Datentyp: 

struct TmpRas *tmpras; 

ULONG Speicher; 
int große; 


Sonstiges: 

Auf die TmpRas-Structure kann wie folgt zugegriffen werden: 

Window:WindowPtr -> RPort-> TmpRas 

Screen:ScreenPtr -> RastPort->TmpRas 

Die Variable "Speicher" wird für die Verwendung bei InitArea 
benötigt, "große" sollte etwa fünfmal so groß sein wie 
"maxein" (siehe InitArea). 

4.1.14 

Move 



Syntax: 

Move(rastport,x,y); 


Funktion: 

Plaziert den Stift an der spezifizierten Position neu. 


Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in dem der Stift neu plaziert 
werden soll. 

x,y - > Die neuen Koordinaten des Stiftes. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct RastPort "Tastport; 
int x, y; 


Sonstiges: 

Dieser Befehl hat etwa die gleiche Funktion wie Draw. Aller¬ 
dings wird hier nicht gezeichnet, sondern nur verschoben. 

4.1.15 

OFF DISPLAY 


Syntax: 

OFFDISPLAY; 


Funktion: 

Schaltet die Bildschirmdarstellung aus. 


Parameter: 

Keine Parameter. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

Keine Variablen. 


Sonstiges: 

Es ist solange nichts zu sehen, bis ON DISPLAY verwendet 
wird. 
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OFF DISPLAY ist ein Makro und befindet sich in 
»gfxmacros.h«. Es muß also folgendermaßen eingelsen wer¬ 
den: 

#include <graphics/gfxmacros.h> 

Referenz: 

Siehe auch ON DISPLAY. 

4.1.16 ON DISPLAY 

Syntax: 

ONDISPLAY; 

Funktion: 

Schaltet die Bildschirmdarstellung an. 

Parameter: 

Keine Parameter. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

Keine Variablen. 

Sonstiges: 

Dieser Zustand ist normal. 

ON DISPLAY ist ein Macro und befindet sich in 

»gfxmacros.h«. Es muß also folgendermaßen eingelsen wer¬ 
den: 

#include <graphics/gfxmacros.h> 

Referenz: 

Siehe auch OFF DISPLAY 

4.1.17 PolyDraw 

Syntax: 

PolyDraw(rastport,anz,&anfang[0]); 

Funktion: 

Zeichnet ein Polygon. 

Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in den gezeichnet werden 
soll. 

anz -> Anzahl der Eckpunkte, die das Polygon 

besitzt. 

&anfang[0] -> Zeiger auf das erste xy-Koordinaten- 

Paar. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct RastPort *rastport; 
int anz; 

USHORT anfang[]; 
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Sonstiges: Wie dieser Befehl genau angewendet wird, ist aus dem 

Demonstrationsprogramm ersichtlich. 

4.1.18 ReadPixel 

Syntax: Nr = ReadPixel(rastport,x,y); 

Funktion: Ermittelt die Farbregisternummer des spezifizierten Punktes. 

Parameter: rastport -> Zeiger auf die RastPort-Structure des 

Rastportes, auf die sich dieser Befehl 
bezieht. 

x,y -> Koordinaten des Punktes, von dem die 

Farbregisternummer ermittelt werden 
soll. 

Ergebnis: Nr -> Farbregisternummer des spezifizierten 

Pixel. 

Datentyp: struct RastPort *rastport; 

int x, y; 
int Nr; 

Sonstiges: Wenn Nr gleich -1 ist, konnte die Farbregisternummer des 

Pixel nicht ermittelt werden. Nr kann die Werte 0 bis 255 und 
-1 annehmen. Dies wurde so gewählt, da eine spätere Version 
des Amiga eventuell mit 8 Bitplanes arbeitet, also 256 Farben 
gleichzeitig darstellen kann. 

Erwähnenswert ist noch, daß die Farbregisternummer zu¬ 
rückgegeben wird, nicht der Farbwert selbst. Dieser kann an¬ 
schließend mit GetRGB4 ermittelt werden. 

4.1.19 RectFill 

Syntax: RectFill(rastport,xl,yo,xr,yu); 

Funktion: Erzeugt ein ausgefülltes Rechteck. 

Parameter: rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in den gezeichnet werden 
soll. 

xl,yo -> Koordinaten des linken, oberen Eck¬ 

punktes 

xr,yu -> Koordinaten des rechten, unteren Eck¬ 

punktes. 
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Ergebnis: Kein Ergebnis. 

Datentyp: struct RastPort *rastport; 

int xl, yo, xr, yu; 

Sonstiges: Gezeichnet wird in der gewählten Zeichenfarbe und mit dem 

gewählten Füllmuster. Ist kein Füllmuster gewählt, wird voll¬ 
ständig ausgefüllt. 


4.1.20 ScrollRaster 


Syntax: 

ScrollRaster(rastport,dx,dy,xl,yo,xr,yu); 

Funktion: 

Scrollt einen gewählten Bereich. 

Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in dem gescrollt werden 
soll. 


dx,dy -> geben an, um wieviele Punkte gescrollt 

werden soll. Wird ein negativer Wert 
angegeben, wird nach links, bzw. oben 
gescrollt. 


xl,yo -> Linker, oberer Eckpunkt des Berei¬ 

ches, der gescrollt werden soll. 


xr,yu -> Rechter, unterer Eckpunkt des Berei¬ 

ches, der gescrollt werden soll. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct RastPort *rastport; 
int dx, dy, xl, yo, xr, yu; 

Sonstiges: 

Der freiwerdende Bereich wird mit der Farbe gefüllt, die mit 
SetBPen gewählt werden kann. 


4.1.21 ScroIIVPort 

Syntax: ScrolIVPort(viewport,dx,dy); 

Funktion: Scrollt einen ganzen Screenbereich. 

Parameter: viewport -> Zeiger auf die ViewPort-Structure des 

Screens, der gescrollt werden soll. 

dx,dy -> Anzahl der Punkte um die gescrollt 

werden soll. Wird ein negativer Wert 
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Ergebnis: 

Datentyp: 

Sonstiges: 


4.1.22 SetAfPt 

Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 


Sonstiges: 


angegeben, wird nach links bzw. oben 
gescrollt. 

Kein Ergebnis. 

struct ViewPort *viewport; 
int dx, dy; 

Dieses Scrolling geschieht zwar langsamer als beim 
MoveScreen-Befehl, vollzieht sich aber immerhin in nur etwa 
1/60 Sekunde. 

Der freiwerdende Bereich wird mit der Farbe gefüllt, die mit 
SetBPen gesetzt werden kann. 


SetAfPt(rastport,&data[0] ,anz); 

Setzt ein Füllmuster, das bei Area-Befehlen verwendet wird. 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, für den dieses Füllmuster 
gelten soll. 

&data[0] -> Zeiger auf ein Feld, das das Füllmuster 

enthält. 

anz -> 2 hoch anz ist gleich der Anzahl der 

Worte, die data enthält. 

Kein Ergebnis. 

struct RastPort *rastport; 

WORD data[]; 
int anz; 

»data« muß immer quadratisch sein. Das heißt, es muß genauso 
viele Worte breit wie hoch sein. Da anz immer als Wurzel aus 
der Anzahl der Worte angegeben wird, können insgesamt 
entweder 1, 2,4, 8,16 usw. Worte verwendet werden. 

Wir wollen nun ein Linienmuster mit jeweils 2 Worten als 
Kantenlänge definieren: 

1010101010101010 

0101010101010101 


Daraus folgt folgende Deklaration: 
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WORD data [] = {OxAAAA 0x5555); 

main () 

{ 

SetAfPt(WindowPtr->RPort,Sdata [0],1) ; 
) 


4.1.23 SetAPen 


Syntax: 

SetAPen(rastport,Nr); 

Funktion: 

Setzt die Zeichenfarbe. 

Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, für den die Zeichenfarbe 
gesetzt werden soll. 


Nr -> Farbregister. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct RastPort * rastport; 
int Nr; 

Sonstiges: 

Da beim Amiga zum Zeichnen nicht die Farbe direkt angegeben 
wird, sondern über Farbregister, muß hier eine Farbregister- 


nummer angegeben werden. 

Die Zeichenfarbe wird für alle direkten Zeichenbefehle ver¬ 
wendet, wie zum Beispiel Draw usw. 

4.1.24 SetBPen 


Syntax: 

SetBPen(rastport.Nr); 


Funktion: 

Setzt die Hintergrundfarbe. 

Parameter: 

rastport -> 

Zeiger auf die RastPort-Structure des 
RastPorts, dessen Hintergrundfarbe ge¬ 
setzt werden soll. 


Nr -> 

Farbregistemummer für die Hinter¬ 
grundfarbe. 

Ergebnis: 

Kein Ergebnis. 



Datentyp: struct RastPort *rastport; 

int Nr; 
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Sonstiges: Hintergrundfarbe ist hier nicht als die Farbe zu verstehen, die 

die Umrandung des Bildschirmes besitzt, sondern als Farbe, 
die zum Beispiel zum Füllen des freiwerdenden Bereiches 
beim Scrollen verwendet wird. 


4.1.25 SetDrMd 


Syntax: - 
Funktion: 
Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


SetDrMd(rastport.mode); 

Setzt den Mode, mit dem gezeichnet wird. 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, dessen Zeichenmode ge¬ 
setzt werden soll. 

mode -> JAM1 - Normalmodus, d.h. die Farbe, 

die mit SetAPen gesetzt wurde, wird 
zum Zeichnen verwendet. 

JAM2 - wird für Füllmuster ver¬ 
wendet. Ist bei einem Füllmuster ein 
"Loch", d.h. ist das Bit nicht gesetzt, 
wird die Hintergrundfarbe (SetBPen) 
verwendet. Ansonsten wird in der Vor¬ 
dergrundfarbe (SetAPen) gezeichnet. 

COMPLEMENT| JAM1 - komple¬ 
mentiert die Vordergrundfarbe. 

COMPLEMENT | JAM2 - komple¬ 
mentiert entweder die Vorder- oder 
die Hintergrundfarbe (siehe JAM2). 

JAM11INVERSVID, beziehungsweise 
JAM21INVERSVID wird für die 
Textdarstellung benutzt. In diesem Fall 
wird die Textdarstellung invertiert. 

Kein Ergebnis. 

struct RastPort *rastport; 
int mode; 

Im Normalfall wird der Modus JAM1 verwendet: 
SetDrMd(WindowPtr->RPort,JAMl); 
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4.1.26 SetDrPt 

Syntax: SetDrPt(rastport.data); 

Funktion: Setzt ein Muster für die Linienzeichnung. 

Parameter: rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, dessen Linienmuster gesetzt 
werden soll. 

data -> ist eine Wortvariable, die das Muster 

enthält. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct RastPort *rastport; 

WORD data; 

Sonstiges: Wir wollen folgendes Muster setzen: 1010101010101010 

Dies ist gleich OxAAAA, also bedeutet dies : 

SetDrPt(WindowPtr- > RPort, OxAAAA); 

4.1.27 SetOPen 

Syntax: SetOPen(rastport.Nr); 

Funktion: Setzt die Farbe, die von einigen Befehlen verwendet wird 

(Beispielsweise ScrollRaster). 

Parameter: rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, für den diese Farbe gesetzt 
werden soll. 

Nr - > Farbregisternummer. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct RastPort *rastport; 

int Nr; 

Sonstiges: Für weitere Informationen über die inverse Textdarstellung 

siehe auch SetDrMd. 

4.1.28 SetRast 


Syntax: 

Funktion: 


SetRast(rastport,Nr); 

Färbt ein gesamtes Window, bzw. einen gesamten Screen in 
der gewünschten Farbe ein. 
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Parameter: 

rastport -> 

Zeiger auf die RastPort-Structure des 
RastPorts, der eingefärbt werden soll. 


Nr -> 

Farbregisternummer, das die Farbe 
angibt, in der eingefärbt werden soll. 

Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct RastPort *rastport; 
int Nr; 

Sonstiges: 

Die ist der einzige Befehl, der es erlaubt, einen gesamten 
RastPort auf einmal einzufärben. 


4.1.29 SetRGB4 


Syntax: SetRGB4(viewport,Nr,r,g,b); 


Funktion: Setzt ein Farbregister auf den spezifizierten Farbwert 


Parameter: viewport 

Nr 

r,g,b 


-> Zeiger auf die ViewPort-Structure des 
Screens, für den die Farbe gesetzt wer¬ 
den soll. 

-> Nummer des Farbregisters, das gesetzt 
werden soll. 

-> geben die Intensität des 
Rot/Grün/Blau-Anteils an. Sie dürfen 
Werte zwischen 0 und 15 annehmen. 


Ergebnis: Kein Ergebnis. 


Datentyp: struct ViewPort *viewport; 

int Nr, r, g, b; 

Sonstiges: Werden r, g und b gleich 0 gewählt, bedeutet dies schwarz. 

Für r, g und b gleich 15 erhält man weiß. 


4.1.30 SetWrMsk 

Syntax: SetWrMsk(rastport,maske); 

Funktion: Schützt bestimmte Bitplanes vor dem Überschreiben. 

Parameter: rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, dessen BitPlanes geschützt 
werden sollen. 
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maske -> gibt an, welche BitPlanes vor dem 

Überschreiben geschützt werden sol¬ 
len. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct RastPort *rastport; 

WORD maske; 

Sonstiges: maske ist vom Typ WORD, also 16 Bits lang. Die unteren 6 

Bits beschreiben den Schreib-Zustand der maximal 6 
BitPlanes, die ein Screen haben kann. 

Wir wollen nun die Planes 2 und 4 vor dem Über- schreiben 
schützen: 

BitPlane 6543210 
1111111111101011 = OxFFEB 

Man verwendet also folgenden Befehl: 

SetWrMsk( WindowPtr- > RPort,OxFFEB); 

4.1.31 VBeamPos 

Syntax: YPos = VBeamPos(); 

Funktion: Ermittelt die momentane Y-Position des Elektronenstrahles 

in der Bildröhre. 

Parameter: Keine Parameter. 

Ergebnis: YPos -> die momentane Position in non- 

interlaced Mode. 

Datentyp: int YPos; 

Sonstiges: Dieser Befehl fragt direkt die Hardware ab. 


4.1.32 WaitBOVP 

Syntax: WaitBOVP(viewport); 

Funktion: Wartet, bis der Elektronenstrahl den Anfang des angege¬ 

benen Screens erreicht hat. 

Parameter: viewport -> Zeiger auf die ViewPort-Structure 

eines Screens. 


Ergebnis: Kein Ergebnis. 
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Datentyp: struct ViewPort *viewport; 

Sonstiges: Dieser Befehl kann verwendet werden, wenn das Programm 

direkt auf die Video-Hardware zugreift und mit dieser in 
Synchronität gebracht werden muß. 

Das Programm wird weiter abgearbeitet, sobald der Elektro¬ 
nenstrahl mit der Darstellung des angegebenen Screens be¬ 
ginnt. Dies muß nicht unbedingt die oberste Position des 
Bildschirms sein, da der Screen auch weiter unten beginnen 
kann (MoveScreen). 


4.1.33 WaitTOF 


Syntax: 

Funktion: 

Parameter: 

Ergebnis: 

Datentyp: 

Sonstiges: 


WaitTOF(); 

Wartet, bis der Elektronenstrahl den Beginn des nächsten, 
darzustellenden Screens erreicht hat. 

Keine Parameter. 

Kein Ergebnis. 

Keine Variablen. 

Auch dieser Befehl kann zur Synchronisation des Programms 
mit der Hardware herangezogen werden. 


4.1.34 WritePixel 


Syntax: WritePixel(rastport,x,y); 


Funktion: 

Dieser Befehl setzt einen einzelnen Punkt, in der mit 
SetAPen angegebenen Farbe an die angegebene Position. 

Parameter: 

rastport 

-> 

Zeiger auf die RastPort-Structure des 
RastPorts, in die der Punkt gesetzt 
werden soll. 


x,y 

-> 

Koordinaten des Punktes. 

Ergebnis: 

Kein Ergebnis. 




Datentyp: struct RastPort *rastport; 

int x, y; 

Sonstiges: Dieser Befehl kann auch durch Draw ersetzt werden, wenn 

der Zeichenstift zuvor mit Move an die Punktposition gesetzt 
wurde. 
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/******************************* 

Graflk-Demonstration 

last update 26/05/87 
von Joerg Koch und Frank Kremser 
(c) Markt & Technik 1987 

** *** # * *# *******#**#*****#*# *#* * 

Diese Demonstration zeigt die einfachen Graflkbefehle des Amiga 
**#*##*****##**#***#*##********#/ 

#include <exec/types.h> /* Laedt die Include-Files */ 

#include <exec/nodes.h> 

#include <exec/lists.h> 

#include <exec/ports.h> 

#include <exec/devices.h> 

#include <devices/keymap.h> 

#include <graphics/regions.h> 

#include <graphics/copper.h> 

#include <graphics/gels.h> 

#include <graphics/gfxbase.h> 

#include <graphics/gfx.h> 

#include <graphics/clip.h> 
ttinclude <graphics/view.h> 

#include <graphics/rastport.h> 

#include <graphics/layers.h> 

#include <graphics/display.h> 

#include <graphics/gfxmacros.h> 

#include <intuition/intuition.h> 

#include <hardware/blit.h> 


struct IntuitionBase *IntuitionBase; /# Lib - Zeiger #/ 
struct GfxBase *GfxBase; 

struct RastPort *rp; /* RastPort - Zeiger #/ 

struct Window *window; /* Window — Zeiger %/ 

struct IntuiMessage *message; /* IntuiMessage - Zeiger %/ 

struct TmpRas tmp; 


struct NewWindow nw = 
< 

30, 

30, 

580, 

200 , 

3 , 

1 , 


/* Window definieren */ 

/# Linke Ecke */ 

/% Rechte Ecke #/ 

/* Breite */ 

/% Hoehe #/ 

/* DetailPen %/ 

/* Block Pen */ 


CLÜSEWIND0WREFRESHWINDOW, /* IDCMP-Flags */ 

WINDOWCLÜSE1 WINDOWS!ZING 1WINDOWDEPTH!WINDOWDRAG1 SMART_REFRESH,/* Flags */ 
NULL, /# Erstes Gadget des Windows */ 

NULL, /# Checkmark */ 

"Die einfachen Graflkbefehle", /# Window-Titel */ 

NULL, /# Zeiger auf Screen */ 

NULL, /# Zeiger auf SuperBitMap #/ 

20, /# Min. Breite #/ 

20, /* Min. Hoehe */ 

640, /* Max. Breite */ 

256, /# Max. Hoehe */ 

WBENCHSCREEN /* Screen-Typ */ 

>; 


LONG mem; 
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126 

127 

128 


main( > 

( 

ULONG MessageClass; 

USHORT code; 

LONG warte; 

/* Gra-fik-Bibliothek oeffnen #/ 

if ( (Gf xBase = (struct GfxBase * )GpenLibrary ( "graphics. 1 ibrary" ,0))) 
{ 

close_things(); 
exit(); 

> 

/* Intuition oeffnen #/ 
if(!(IntuitionBase = (struct IntuitionBase *) 

OpenLibrary("Intuition.1ibrary",0))) 

( 

close_things< >; 
exit(); 

) 


i-f ('.(window = (struct Window *)GpenWindow(&nw) )) /# Window oe-f-fnen %/ 

< 

close_things(); 
exit(); 

> 


rp = wmdow->RPort; 

mem = AllocRaster(640,256); /* Speicherplatz fuer Flood bereitstellen */ 
rp->TmpRas = (struct TmpRas *)InitTmpRas(&tmp 

,mem, RASSIZE(640,256)); 


SetDrMd(rp,JAM1); 
SetAPen(rp,2); 

Move(rp,20,20); 

Draw(rp,20,180); 
Draw(rp,560,180); 
Draw(rp,560,20); 
Draw(rp,20,20); 
Draw(rp,560,180); 
Move(rp,560, 20); 
Draw (rp, 20,180); 

Flood(rp,1,30,22); 
Flood(rp,1,30,178); 


/* Drawmode setzen #/ 

/* Farbregister zum Zeichnen setzen */ 
/* Stift neu positionieren */ 

/* Linie zur neuen Position zeichnen #/ 


/# Flaechen fuellen */ 


for(warte=0; warte<100000; warte++); /* Einen Moment warten */ 


SetBPen(rp,0); /* Hintergrundfarbe setzen und scrollen */ 

for(warte=0; warte<160; warte++) ScrollRaster(rp,4,1,10,10,570,190); 

for(warte=0; warte<50000; warte++); /* Einen Moment warten */ 


RectFil1(rp,1,10,578,198); 


/% ausgefuel1tes Rechteck */ 


SetAPen(rp,3); 

for(warte=0; warte<580; warte=warte+3) WritePixel(rp,warte,100); 

'% gestrichelte Linie zeichnen %/ 
for(;;) /* Endlosschleife */ 

< /* Message empfangen und verarbeiten */ 

lf (message = (struct IntuiMessage *)GetMsg(window->UserPort)) 

< 

MessageClass = message->Class; /* Message retten #/ 
code = message->Code; 
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129 Rep1yMsg(message); /# Message quittieren */ 

130 if (MessageClass = CL0SEWIND0W) <close_things( ); exit();>; 

131 >; /# Wenn bestimmte Message, dann tue... */ 

132 > 

133 > 

134 

135 close_things() /* Unterroutine zum Abschluss des Programm */ 

136 { 

137 FreeRaster(mem,640,256 >; 

138 CloseWindow(window>; 

139 CloseLibrary(GfxBase); 

140 CloseLibrary(IntuitionBase); 

141 > 


1 /************************>******* 

2 

3 Area - Demonstration 

4 last update 25/05/87 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt & Technik 1987 

7 

8 ******************************** 

9 

10 Zeichnet zwei Polygone auf den Screen 

11 

12 *******************************/ 

13 

14 «include <exec/types.h> /* Include - Files einiesen */ 

15 #include <exec/nodes.h> 

16 «include <exec/lists.h> 

17 «include <exec/ports.h> 

18 «include <exec/devices.h> 

19 «include <devices/keymap.h> 

20 «include <graphics/regions.h> 

21 «include <graphics/copper.h> 

22 «inc1ude <graphics/ge1s.h> 

23 «include <graphics/gfxbase.h> 

24 «include <graphics/gfx.h> 

25 «include <graphics/clip.h> 

26 «include <graphics/view.h> 

27 «include <graphics/rastport.h> 

28 «include <graphics/layers.h> 

29 «include <graphics/display.h> 

30 «include <graphics/g-fxmacros.h> 

31 «include <intuition/intuition.h> 

32 «include <hardware/blit.h> 

33 

34 struct IntuitionBase »IntuitionBase; /* Intuition-Pointer definieren #/ 

35 struct GfxBase »GfxBase; /» Graphics-Lib-Pointer definieren »/ 

36 struct Screen »screen; /» Screen - Pointer de-finieren %/ 

37 

38 struct NewScreen ns = /» Screen - Struktur */ 

39 { 


40 

o, 


41 

o, 

/* Startposition */ 

42 

640, 

/% Breite */ 

43 

256, 

/* Hoehe */ 

44 

2, 

/» Tiefe */ 

45 

1. 

/* DetailPen */ 

46 

0, 

/# BlockPen #/ 

47 

HIRES, 

/♦ ViewModes */ 
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48 CUSTOMSCREEN, /* Screen-Typ */ 

49 NULL, /* Zeiger auf Font - Strucure */ 

50 "Die Area-Befehle", /* Screen - Titel %/ 

51 NULL, /* Gadgets */ 

52 NULL /* selbsterstelltes BitMap %/ 

53 >; 

54 

55 

56 main() 

57 { 

58 LC3NG warte; /* Variable fuer Warte - Schleife #/ 

59 WORD areabufferC250J; /* areapuffer = 250 Words gross */ 

60 struct RastPort *rp; /* rp = Pointer auf RastPort #/ 

61 struct TmpRas tmp; /* tmp = TmpRas - Structure #/ 

62 struct Areainfo areainfo; /* areainfo = Areainfo Structure */ 

63 LONG mem; /* Variable fuer Speicherplatz #/ 

64 /# Libs oeffnen */ 

65 if(!(GfxBase = (struct GfxBase *) 

66 OpenLibrary( "graphics. 1 ibrary" ,0 ))) exitO; 

67 

68 if(!(IntuitionBase = (struct IntuitionBase #) 

69 OpenLibrary("intuition.1ibrary",0))) exit<); 

70 /# Screen oeffnen */ 

71 if ('(screen = (struct Screen *)OpenScreen(&ns) )) exit(); 

72 

73 rp = &screen->RastPort; 

74 mem = AllocRaster(640,256); /* Speicher fuer Areas bereitstelleri */ 

75 /* Area initialisieren */ 

76 InitArea(&areainfo, areabuffer, 100); 

77 rp->TmpRas = (struct TmpRas *)InitTmpRas(&tmp 

78 ,mem,RASSIZE(640,256)); 

79 rp->AreaInfo = &areainfo; 

80 

81 SetDrMd(rp,JAM1); /* Zeichenmodus und Farbe setzen */ 

82 SetAPen(rp,3); 

83 

84 AreaMove(rp,0,0); /% Polygone definieren #/ 

85 AreaDraw(rp,50,50); 

86 AreaDraw(rp,100,100); 

87 AreaDraw(rp,200,50); 

88 AreaDraw(rp,100,250); 

89 

90 AreaMove(rp,400,100); 

91 AreaDraw(rp,450,100); 

92 AreaDraw<rp,450,150); 

93 AreaDraw(rp,400,150); 

94 

95 AreaEnd(rp); /# Polygone zeichnen */ 

96 

97 for(warte = 0; warte < 300000; warte++); /* Warte-Schleife */ 

98 

99 FreeRaster(mem,640,256); 

100 CloseScreen(screen); 

101 CloseLibrary(GfxBase); 

102 CloseLibrary(IntuitionBase); 

103 > 


/% Area-Speicher loeschen */ 

/* Screen und Libs schliessen #/ 
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4.2 Die Textfunktionen 

Der Amiga stellt nicht nur mächtige Grafikbefehle zur Verfügung, sondern 
er beherrscht auch die Fähigkeit der Schriftenvielfalt. Mit einigen Befehlen 
kann sehr leicht zwischen den verschiedenen Zeichensätzen umgeschaltet 
werden, die wiederum ebenfalls mit Leichtigkeit modifiziert werden können. 

Wie kann nun auf die Schriftenvielfalt zugegriffen werden? 

1. Mit AvailFonts muß ermittelt werden, welche Zeichensätze zur Ver¬ 
fügung stehen. 

2. Mit OpenFont, bzw. OpenDiskFont müssen diese bereitgestellt werden. 

3. Mit AddFont werden sie dem System verfügbar gemacht. 

4. Mit SetFont wird ein Zeichensatz aktiviert. 

5. Mit AskSoftStyle und SetSoftStyle kann seine Darstellungsweise ver¬ 
ändert werden. 

6. Mit Text können die Zeichen auf den Bildschirm gebracht werden. 

7. Mit RemFont können die Zeichensätze dem System "entzogen" werden. 

8. Mit CloseFont können Zeichensätze aus dem Speicher entfernt werden. 

Der Befehl Text ist der eigentliche Druckbefehl, denn dieser bringt die Zei¬ 
chen auf den Schirm. Allerdings geht er von der Position aus, an der der 
Textcursor steht. Dieser Textcursor wird mit den Grafikbefehlen Move, 
Draw usw. verschoben. Das bedeutet, der Textcursor ist mit dem Grafikstift 
identisch. 

Einzelheiten erfahren Sie aus der folgenden Befehlsbeschreibung und aus 
dem Demonstrationsprogramm. 

4.2.1 AddFont 

Syntax: AddFont(textfont) 

Funktion: Hängt einen Zeichensatz an die Zeichensatzliste des Systems 

an. Dieser Zeichensatz kann anschließend angesprochen 
werden, wie jeder andere Zeichensatz auch. Das heißt, in 
einer NewWindow- oder NewScreen-Structure kann dieser 
Zeichensatz angegeben werden. 

Parameter: textfont -> Zeiger auf die TextFont-Structure des 

Zeichensatzes, der angehängt werden 
soll. 
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Ergebnis: 

Datentyp: 

Sonstiges: 


Referenz: 

4.2.2 AskFont 

Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


Kein Ergebnis. 

struct TextFont *textfont; 

Den Zeiger auf die TextFont-Structure bekommt man durch 
die Befehle OpenFont und OpenDiskFont. Diese Befehle 
laden Zeichensätze in das System, aber erst durch AddFont 
sind diese für das System "erreichbar". 

Soll für einen Screen ein eingeladener Zeichensatz verwendet 
werden, so muß in der NewScreen-Structure zu Beginn ein 
Zeiger auf die entsprechende TextAttr-Structure gesetzt wer¬ 
den. Diese bekommt man beispielsweise durch den 
AvailFonts Befehl. Die TextAttr-Structure wird auch für 
OpenFont und OpenDiskFont benötigt, durch die man einen 
Zeiger auf die TextFont-Structure erhält. 

Das Ganze mag an dieser Stelle etwas komplex klingen, doch 
sieht man sich das Demonstrationsprogramm an, wird deut¬ 
lich, daß das Ganze erheblich einfacher ist, als es hier darzu¬ 
stellen ist. 

Siehe auch OpenDiskFont und OpenFont 


AskFont(rastport,textattr); 

Dieser Befehl bewirkt das Setzen der TextAttr-Structure mit 
den Werten des momentan angewählten Zeichensatzes. 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, dessen Zeichensatz abge¬ 
fragt werden soll. 

textattr -> Zeiger auf eine leere TextAttr- 

Structure. 

Kein Ergebnis. 

struct RastPort *rastport; 
struct TextAttr *textattr; 

Dieser Befehl wird verwendet, um abzufragen, welcher Zei¬ 
chensatz derzeit in dem spezifizierten RastPort verwendet 
wird. 
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Die TextAttr-Structure ist wie folgt aufgebaut: 
struct TextAttr { 

STRPTR ta_Name; Zeiger auf den Zeichensatzname 

UWORD ta_YSl2e; Höhe der Zeichen in Pixel 

UBYTE ta_Style; Zeichensat2-Stil (s. AskSoftStyle) 

UBYTE ta_Flags; Zeichensatz-Einstellungen 
): 

Der Zeichensatzname ist bei dem voreingestellten Zeichen¬ 
satz entweder Topaz-60 oder Topaz-80. 


4.2.3 AskSoftStyle 


Syntax: 

maske = AskSoftStyle(rastport); 

Funktion: 

Ermittelt die momentane Einstellung des Zeichensatzes. 

Parameter: 

rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, für dessen Zeichensatz die 
Einstellung ermittelt werden soll. 

Ergebnis: 

maske -> enthält die Einstellungen des Zeichen¬ 

satzes. 

Datentyp: 

struct RastPort *rastport; 

BYTE maske; 

Sonstiges: 

Jeder Zeichensatz kann mit SetSoftStyle noch verändert wer¬ 
den. Wie der Zeichensatz momentan eingestellt ist, kann mit 
AskSoftStyle ermittelt werden. 


»maske« ist vom Typ BYTE, wobei nur die unteren 4 Bits 
verwendet werden: 


00000000 = 0 <-> Normal 

00000001 = 1 <-> Unterstrichen 

00000010 = 2 <-> Fettdruck 

00000100 = 4 <-> Schrägschrift 

00001000 = 8 <-> Breitschrift 


Das bedeutet, wenn »maske« gleich 5 ist, werden die Zeichen 
unterstrichen und schräg gedruckt. 


4.2.4 AvailFonts 

Syntax: fehler = AvailFonts(puffer,bytes,typen); 

Funktion: Ermittelt alle erreichbaren Zeichensätze aus dem Speicher 

und von der Diskette. 
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Parameter: 


Ergebnis: 


Datentyp: 


Sonstiges: 


puffer 


bytes 

typen 


fehler 


- > Zeiger auf den Speicherbereich, in den 

eine AvailFontsHeader-Structure und 
für jeden Zeichensatz jeweils eine 
AvailFont-Structure eingetragen wird. 

- > Größe des Puffers in Bytes. 

-> Hier muß AFF MEMORY angegeben 
werden, wenn nur im Speicher nach 
den Zeichensätzen gesucht werden soll. 

AFFDISK kann angegeben werden, 
wenn nur auf Diskette nach den Zei¬ 
chensätzen gesucht werden soll. 

Wird AFFMEMORY | AFFDISK 
angegeben, wird sowohl im Speicher, 
als auch auf der Diskette nach den Zei¬ 
chensätzen gesucht. 

-> ist 0, wenn alles in Ordnung war. Ist 
fehler ungleich 0, gibt diese Variable 
die Anzahl der Bytes an, um die der 
Puffer vergrößert werden muß. 


ULONG puffer; 
int bytes, typen; 
int fehler; 


Die AvailFontsHeader-Structure ist äußerst einfach aufge¬ 
baut. Sie besteht nur aus einem einzigen Eintrag, der Anzahl 
der gefundenen Zeichensätze. Dieser Eintrag ist vom Typ 
WORD, kann also einfach abgefragt werden, in dem die 
ersten zwei Bytes des Puffers ermittelt werden. Diesem 
schließt sich eine Anzahl von AvailFonts-Structures an, die 
folgendermaßen aufgebaut sind: 


struct AvailFonts 
{ 

UWORD af_Type; AFF_MEMORY oder AFF_DISK 

struct TextAttr af_Attr; TextAttr-Structure 

): 


Für jeden gefundenen Zeichensatz ist eine AvailFonts- 
Structure vorhanden. Ist ”af_Type" gleich AFF MEMORY, 
ist der Zeichensatz schon im Speicher, bei AFF DISK, muß 
er noch von Diskette geladen werden, um ihn zu benutzen. 
Die TextAttr-Structure wird für OpenFont und 
OpenDiskFont benötigt. 
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4.2.5 ClearEOL 

Syntax: ClearEOL(rastport); 

Funktion: Löscht von der derzeitigen Textcursor-Position in dem ange¬ 

gebenen RastPort bis zum Ende der Zeile. 

Parameter: rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, in dem gelöscht werden soll. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct RastPort *rastport; 

Sonstiges: Der freiwerdende Bereich wird mit der Hintergrundfarbe, die 

mit SetBPen gesetzt werden kann, gefüllt. 

Referenz: Siehe auch ClearScreen 

4.2.6 ClearScreen 

Syntax: ClearScreen(rastport); 

Funktion: Löscht den gesamten Bereich, der durch das RastPort de¬ 

finiert ist. 

Parameter: rastport -> Zeiger auf die RastPort-Structure des 

RastPorts, der gelöscht werden soll. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct RastPort *rastport; 

Sonstiges: Der freiwerdende Bereich wird in der Hintergrundfarbe, die 

mit SetBPen gesetzt werden kann, gefüllt. 

Referenz: Siehe auch ClearEOL 

4.2.7 CloseFont 

Syntax: CloseFont(textfont); 

Funktion: Schließt einen, mit OpenFont oder OpenDiskFont geöffne¬ 
ten, Zeichensatz und löscht ihn aus dem Speicher, was beson¬ 

ders dann zu empfehlen ist, wenn der Speicherplatz zur Neige 
geht. 

-> Zeiger auf die TextFont-Structure des 
Zeichensatzes, der nicht mehr benötigt 
wird. 


Parameter: textfont 
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Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct TextFont *textfont; 

Sonstiges: 

Der Zeichensatz wird natürlich nicht von der Diskette ge¬ 
löscht! 


Zu der TextFont-Structure gelangt man über die OpenFont 
und OpenDiskFont Befehle. 

Referenz: 

Siehe auch OpenFont und OpenDiskFont 

OpenDiskFont 

Syntax: 

textfont = OpenDiskFont(textattr); 

Funktion: 

Holt einen, mit textattr spezifizierten, Zeichensatz von der 
Diskette in den Speicher. 

Parameter: 

textattr -> Zeiger auf die TextAttr-Structure des 

Zeichensatzes, der geladen werden soll. 

Ergebnis: 

textfont -> Zeiger auf die TextFont-Structure des 

Zeichensatzes, die beispielsweise für 
AddFont benötigt wird. 

Datentyp: 

struct TextAttr *textattr; 
struct TextFont *textfont; 

Sonstiges: 

Dieser Befehl lädt nur einen Zeichensatz in den Speicher. 
Verfügbar ist er erst nach dem AddFont Befehl. 

Referenz: 

Siehe auch OpenFont und AddFont 
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4.2.9 

OpenFont 



Syntax: 

textfont = OpenFont(textattr); 


Funktion: 

Sucht nach einem, im Speicher abgelegten, Zeichensatz. 


Parameter: 

textattr -> Zeiger auf die TextAttr-Structure des 

zu suchenden Zeichensatzes. 


Ergebnis: 

textfont -> Zeiger auf die TextFont-Structure des 

Zeichensatzes, die für AddFont benö¬ 
tigt wird. 


Datentyp: 

struct TextAttr *textattr; 
struct TextFont *textfont; 


Sonstiges: 

Erst wenn anschließend der AddFont Befehl gegeben wird, 
kann der spezifizierte Zeichensatz verwendet werden. 


Referenz: 

Siehe auch OpenDiskFont und AddFont 

4.2.10 

RemFont 



Syntax: 

fehler = RemFont(textfont); 


Funktion: 

Löscht den spezifizierten Zeichensatz aus der Zeichensatz¬ 
liste des Systems, wodurch er für dieses nicht mehr verfügbar 
ist. 


Parameter: 

textfont -> Zeiger auf die TextFont-Structure des 

zu entfernenden Zeichensatzes. 


Ergebnis: 

fehler - > ist 0, wenn kein Fehler auftrat. 


Datentyp: 

struct TextFont *textfont; 
int fehler; 


Sonstiges: 

Dieser Befehl löscht den Zeichensatz nicht aus dem Speicher. 
Soll dies geschehen, muß anschließend noch der Befehl 
CloseFont gegeben werden. 

4.2.11 

SetFont 



Syntax: 

fehler = SetFont(rastport,textfont); 


Funktion: 

Ordnet dem spezifizierten RastPort einen bestimmten Zei¬ 
chensatz zu. 
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Parameter: 

rastport -> 

Zeiger auf die RastPort-Structure des 
RastPorts, dem ein Zeichensatz zuge¬ 
ordnet werden soll. 


textfont - > 

Zeiger auf die TextFont-Structure des 
Zeichensatzes, der dem RastPort zuge¬ 
ordnet werden soll. 

Ergebnis: 

fehler - > 

ist 0, wenn kein Fehler aufgetreten ist. 

Datentyp: 

struct RastPort "reastport; 
struct TextFont "'textfont; 
int fehler; 

Sonstiges: 

Nach diesem Befehl werden sämtliche Textausgaben in die¬ 
sem RastPort mit dem neuen Zeichensatz ausgegeben. 


4.2.12 SetSoftStyle 

Syntax: neumaske = SetSoftStyle(rastport,neu,maske); 

Funktion: Setzt einen neuen Darstellungsmodus. 


Parameter: 

rastport 

-> Zeiger auf die RastPort-Structure des 
RastPorts, für den ein neuer Darstel¬ 
lungsmodus gesetzt werden soll. 


neu 

-> Eine Byte-Variable, die den neuen 
Darstellungsmodus enthält. Wie sie ge¬ 
setzt werden kann, ist unter dem 
Befehl AskSoftStyle beschrieben. 


maske 

-> gibt an, welche Bits verändert werden 
dürfen. Diese Variable wird von einem 
Aufruf AskFontStyle zurückgegeben 
(siehe dort). 

Ergebnis: 

neumaske 

-> hat die gleiche Funktion wie »maske«, 
jedoch sind die Bit’s, die durch »neu« 
bestimmt wurden, schon gesetzt. 

Datentyp: 

struct RastPort 

*rastport; 


BYTE neu, maske, neumaske; 

Sonstiges: 

Für weitere Einzelheiten siehe AskSoftStyle. 

Referenz: 

Siehe auch AskSoftStyle 
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4.2.13 Text 


Syntax: fehler = Text(rastport,&strptr[0], länge); 

Funktion: Schreibt den angegebenen Text in das RastPort, an die mo¬ 

mentane Position des Textcursors. 


Parameter: 

rastport 

-> 

Zeiger auf die RastPort-Structure des 
RastPorts, in den geschrieben werden 
soll. 


&strptr[0] 

-> 

Zeiger auf den Text, der ausgegeben 
werden soll. 


länge 

-> 

Anzahl der auszugebenden Buchsta¬ 
ben. 

Ergebnis: 

fehler 

-> 

ist 0, wenn kein Fehler auftrat. 

Datentyp: 

struct RastPort 
char strptr[]; 
int länge; 

"Tastport; 

Sonstiges: 

Mit diesem Befehl muß vorsichtig umgegangen werden, da 
unerwünschte Effekte auftreten können, falls der Text über 
den Rand hinausragt. 


4.2.14 TextLength 

Syntax: pix = TextLength(rastport,&strptr[0],länge); 

Funktion: Ermittelt die Länge in Pixel für den angegebenen Text. 


Parameter: 

rastport 

-> 

Zeiger auf die RastPort-Structure des 
RastPorts, für die die Textlänge er¬ 
mittelt werden soll. 


&strptr[0] 

-> 

Zeiger auf den Text, dessen Länge er¬ 
mittelt werden soll. 


länge 

-> 

Anzahl der Zeichen, die dieser Text 
enthält. 

Ergebnis: 

pix 

-> 

Anzahl der Grafikpunkte, die dieser 
Text benötigt. 
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Datentyp: struct RastPort *rastport; 

char strptr[]; 
int länge; 
int pix; 

Sonstiges: Dieser Befehl ermittelt nicht die Anzahl der Buchstaben, die 

der Text enthält, denn diese müssen beim Aufruf schon mit¬ 
angegeben werden. 

1 /*#***************************** 

2 

3 Text-Demonstration 

4 last update 26/05/87 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt & Technik 1987 

7 

8 ******************************** 

9 

10 Darstellen 5 verschiedener Fonts, die sich au-f der Diskette be-finden, 

11 mit Hilfeder Intuitext-Funktion. 

12 

13 *******************************/ 

14 

15 #include "exec/types.h" /* Include-Files werden eingelesen */ 

16 #include "exec/io.h" 

17 #include "exec/memory.h" 

18 #include "exec/exec.h" 

19 #include "graphics/g-fx.h'* 

20 ttinclude "hardware/dmabits.h" 

21 #include "hardware/custom.h" 

22 ttinclude "hardware/blit.h" 

23 #include "graphics/g-f xmacros. h" 

24 #include "graphics/copper.h" 

25 ttinclude "graphics/view.h" 

26 #include "graphics/gels.h" 

27 #include "graphics/regions.h" 

28 #include "graphics/clip.h" 

29 #include "graphics/text.h" 

30 #include "graphics/g-fxbase.h" 

31 #include "devices/keymap.h" 

32 #include '‘libraries/dos.h" 

33 #include "graphics/text.h" 

34 #include "intuition/intuition.h” 

35 #include "libraries/disk-font.h" 

36 

37 struct TextFont *textfont; /* Font-Zeiger */ 

38 struct TextAttr textattr; 

39 

40 struct IntuitionBase *IntuitionBase; /* Lib-Zeiger */ 

41 struct G-fxBase #G-fxBase; 

42 ULONG DiskfontBase; 

43 

44 struct RastPort #rp; 

45 struct NewScreen ns = /* New-Screen Struktur */ 

46 { 

47 0, /# linke Ecke */ 

4Q 0, 7* obere Ecke */ 

49 640, 7* Breite */ 

50 256, 7* Hoehe */ 


Die Textfunktionen 127 


51 

2 , 

/% Tie-fe */ 

52 

0 , 

/* DetailPen */ 

53 

1 , 

/# BlockPen %/ 

54 

H1RES, 

/% ViewModes #/ 

55 

CUST0MSCREEN, 

/% Type #/ 

56 

NULL, 


57 

"Text-Demonstration", 

/# Screen Titel #/ 


58 NULL, 

59 NULL 

60 >; 

61 

62 

63 mainO 

64 { 

65 struct Screen »screen; 

66 LONG warte; /* oeffnen der Libraries #/ 

67 

68 IntuitionBase = (struct IntuitionBase KO 

69 QpenLibrary("intuition.library",0); 

70 if(IntuitionBase — NULL) exit(); 

71 

72 GfxBase = (struct GfxBase KO 

73 OpenLibrary("graphics.library",0); 

74 if(GfxBase = NULL) exit(); 

75 

76 DiskfontBase = OpenLibrary( "diskfont. 1 ibrary" ,0); 

77 lf(DiskfantBase == NULL) exitO; 

78 

79 i-f ( (screen = (struct Screen *) /* oeffnen des Screens %/ 

80 OpenScreen(&ns)) == NULL) exit(); 

81 

82 rp = &screen->RastPort; 

83 


84 

textattr. ta_Name = "ruby.-font"; 

/* 

Struktur zur Festlegung 

%/ 

85 

textattr.ta_YSize = 12; 

/* 

der Font-Art deklarieren 

*/ 

86 

textattr.ta_Style = 8 ; 

/* 

Schriftart */ 


87 

textattr.ta_Flags = 0 ; 




88 





89 

text-font = (struct TextFont * )0penDiskFont(&textattr); 


90 

i -f (tex t -f an t ! = 0 ) 

/* 

Disk-font oe-f-fnen */ 


91 

< 




92 

SetFont(rp,textfont); 

/* 

Schrift setzen #/ 


93 

Move(rp,0,40); 

/* 

Font Zeichen und schliessen */ 

94 

Text(rp,"Dies ist Ruby 12",16); 

/* 

Text ausgeben */ 


95 

CloseFont(text-font); 

/* 

Font schliessen */ 


96 

>; 




97 





98 

textattr. ta_Name = "emerald.-font" ; 

/* 

naechster Font #/ 


99 

textattr.ta_YSize = 20; 




100 

textattr.ta_Style = 1; 




101 

textattr.ta_Flags = 0 ; 





102 text-font = (struct TextFont % )QpenDiskFcnt(&textattr); 

103 i-f(text-font != 0) 

104 { 

105 SetFonttrp, text-font); 

106 Move(rp,0,60); 

107 Text(rp,"Dies ist Emerald 20",19); 

108 CloseFont( text-font); 

109 >; 

110 

111 textattr. ta_Name = "opal. -font" ; 

112 textattr.ta_YSize = 12; 

113 textattr.ta_Style = 4; 


/* noch ein Font */ 
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114 textattr.ta_Flags = 0; 

115 texttont = (struct TextFont *)0penDiskFont(&textattr); 

116 it(texttont '.= 0) 

117 C 

118 SetFont(rp, text-font); 

119 Move(rp,0,80); 

120 Text(rp,"Dies ist Opal 12",16); 

121 CloseFont(texttont); 

122 >; 

123 

124 textattr. ta_Name = "gamet. tont"; /* naechster Font #/ 

125 textattr.ta_YSize = 16; 

126 textattr.ta_Style = 8; 

127 textattr.ta_Flags = 0; 

128 text-font = (struct TextFont *)0penDiskFont(&textattr); 

129 i-f( texttont '.= 0) 

130 { 

131 SetFont(rp,texttont); 

132 Move(rp,0,100); 

133 Text(rp,"Dies ist Garnet 16",18); 

134 CloseFont(texttont); 

135 ); 

136 

137 textattr.taJMame = "sapphire.tont"; /# letzter Fant */ 

138 textattr.ta_YSize = 19; 

139 textattr.ta_Style = 3; 

140 textattr.ta_Flags = 0; 

141 texttont = (struct TextFont *)0penDiskFont<&textattr); 

142 it(texttont != 0) 

143 < 

144 SetFont(rp,texttont); 

145 Move(rp,0,120); 

146 Text(rp,"Dies ist Sapphire 19",20); 

147 CloseFont(texttont); 

148 >; 

149 

150 tor(warte = 0; warte < 1000000; warte++); 

151 

152 CloseScreen(screen); /% Schleite bis 1000000, dann 

153 CloseLibrary(IntuitionBase); /* Libs schliessen %/ 

154 CloseLibrary(GtxBase); 

155 CloseLibrary(DisktontBase); 

156 > 


*/ 
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4.3 Die Images 

Für viele Anwendungen werden Images benötigt. So kann einem Gadget 
etwa ein eigenes Image zugewiesen werden. Dieses Image besteht aus Infor¬ 
mationen über die Form, die Farbe und die Höhe. 

Um ein Image benutzen zu können, muß allerdings zuerst eine Image- 
Structure erstellt werden. Diese hat folgende Form: 

struct Image 
{ 

SHORT LeftEdge, TopEdge; Koord. der linken, oberen Ecke 
SHORT Wldth, Helght, Depth; Breite, Höhe und Tiefe des Images 
SHORT »ImageData; Zeiger auf die Imagedaten 

UBYTE PlanePick, PlaneOnOff; Angaben für die Farben 
struct Image «Nextlmage; Zeiger auf ein weiteres Image 
>: 

Die Angaben über die linke, obere Ecke werden später zu den Angaben, die 
in der Gadget-Structure oder bei Drawlmage stehen, hinzuaddiert. Die Höhe 
und Breite des Image muß in Pixel angegeben werden. Die Tiefe gibt an, 
wieviele BitPlanes das Image belegt. Der Zeiger auf das nächste Image kann 
im Normalfall auf »NULL« gesetzt werden. 

Im Gegensatz zu den Sprites müssen bei Images bei der Definition der 
Image-Daten die Daten für die erste Plane und die zweite Plane getrennt 
werden. 

Wir wollen an dieser Stelle ein Rechteck definieren, das 16 Pixel breit und 
4 Pixel hoch ist: 



II bedeutet, daß BltPlane 0 verwendet wird. 
§§s bedeutet, das BltPlane 1 verwendet wird. 


Daraus ergeben sich für BitPlane 0 folgende Werte: 

0xFFFF 

0x8000 

0x8000 

0x0000 

Für BitPlane 1 ergeben sich dann die Werte 

0x0000 

0x0001 

0x0001 

0XFFFF 
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Die Image-Daten müssen also folgendermaßen deklariert werden: 

USHORT data[] » 

{ 

0xFFFF, /» erste Plane */ 

0x8000, 

0x8000, 

0x0000, 

0x0000, /* zweite Plane */ 

0x0001 , 

0x0001 , 

0xFFFF 

>; 

Die Image-Structure hat im Programm dann folgendes Aussehen: 

struct Inage ownlmage - 
{ 

0 , 

0 , 

16, 

4, 

2 , 

&data[0], 

5. 

0 , 

NULL 

)i 

Mit dem Befehl DrawImage(RastPort,&ownimage,x,y); kann das Image auch 
direkt auf den Bildschirm gezeichnet werden. 

RastPort ist ein Zeiger auf die RastPort-Structure des RastPorts, in den ge¬ 
zeichnet werden soll, x und y geben die Position an, an der das Image ge¬ 
zeichnet werden soll, x und y werden zu LeftEdge und TopEdge hinzu¬ 
addiert. 

PlanePick bezeichnet im übrigen, welche BitPlanes gesetzt werden sollen, 
wenn ein Punkt im Image gesetzt ist. PlaneOnOff hat den gleichen Zweck für 
die Punkte, die nicht gesetzt sind. 

Folgende Werte können PlanePick und PlaneOnOff bei einem Screen mit 
drei Bitplanes annehmen - Für einen Screen mit mehr Bitplanes können Sie 
die Folge immer weiter führen, die Regel erkennen Sie sicher leicht aus der 
folgenden Reihe -: 
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0 

1 

2 

3 

4 

5 

6 
7 


- > Keine Planes sollen gesetzt werden. 

-> Plane 0 soll gesetzt werden. 

- > Plane 1 soll gesetzt werden. 

- > Planes 0 und 1 sollen gesetzt werden. 

- > Plane 2 soll gesetzt werden. 

- > Planes 0 und 2 sollen gesetzt werden. 

- > Planes 1 und 2 sollen gesetzt werden. 

-> Planes 0,1 und 2 sollen gesetzt werden. 


Da unser Image zwei Bitplanes verwendet, kommen für PlanePick also nur 
die Werte 3, 5 und 6 in Betracht. Für PlaneOnOff wählen wir 0, da keine 
Farbe gesetzt werden soll. 
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4.4 Umrahmungen: Borders 

Borders werden für Umrahmungen eingesetzt. Für die Verwendung muß 
eine Anzahl von Eckpunkten angegeben werden, die durch Linien verbunden 
werden. Um sie einsetzten zu können, muß als erstes eine Border-Structure 
deklariert werden. Diese hat folgende Form: 

struct Border 
{ 

SHORT LeftEdge, TopEdge; Koord. der linken, oberen Ecke 
SHORT FrontPen, BackPen, DrawMode; Farben und Zeichenmodus 
SHORT Count; Anzahl der Ecken 

SHORT *XY; Zeiger auf die Eckdaten 

struct Border « NextBorder; Zeiger auf nächste Border 

) 

Die Angaben über die linke, obere Ecke werden später zu den Angaben, die 
in der Gadget-Structure oder bei DrawBorder stehen, hinzuaddiert. 
FrontPen gibt die Farbe an, in der die Border normalerweise gezeichnet 
wird. Wird für DrawMode nicht JAM1, sondern JAM2 gewählt, so wird auch 
die Farbe, die mit BackPen angegeben ist, verwendet (nähere Angaben unter 
SetDrMd). Der Zeiger auf die nächste Border kann im Normalfall auf 
»NULL« gesetzt werden. 

Count gibt an, wieviele Eckpunkte die Border besitzt. XY ist der Zeiger auf 
das Feld,in dem die Koordinaten der Eckpunkte eingetragen sind. 

Wir wollen nun eine Border erstellen. Als erstes müssen die Eckpunkte an¬ 
gegeben werden: 

USHORT datat] = 

{ 

100.100, /» Startpunkt */ 

100,200, 

200 , 200 , 

200 . 100 , 

100,100 /* und zurück zum Startpunkt */ 

); 

Anschließend wird die Border-Structure erstellt: 

struct Border rahmen * 

{ 

0, /* Linke und Obere Ecke würden zu den Border-Daten */ 

0, /* hinzuaddiert werden */ 

3, 

0 , 

J AM 1 , 

5, 

&data[0], 

NULL 

h 
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Mit DrawBorder(RastPort,&rahmen,x,y); kann die Border dann direkt auf 
den Bildschirm gezeichnet werden. 

RastPort ist ein Zeiger auf die RastPort-Structure des RastPorts, in den 
gezeichnet werden soll, x und y geben die Position an,an der die Border 
gezeichnet werden soll, x und y werden zu LeftEdge und TopEdge und den 
Punktkoordinaten hinzuaddiert. 

1 /%%%%%%%%%*%%%*%**%%%%**%%%%%%%* 

2 

3 Image- und Border-Demonstration 

4 last update 26/05/87 

5 von Joerg Koch und Frank Kremser 

6 (c) Markt & Technik 1987 

7 

B ******************************** 

9 

10 Diese Demonstration zeigt die Anwendungsmoeg1ichkeiten von Images und 

11 Borders. Auch Images koennen ohne weiteres zur Animation verwendet werden. 

12 

13 ******************************/ 

14 

15 

16 #include "exec/types.h" /* Einladen der Include-Files #/ 

17 #include "exec/io.h" 

18 #include "exec/memory.h" 

19 #include "exec/exec.h" 

20 #include "graphics/g-fx.h" 

21 #include "hardware/dmabits.h" 

22 #include "hardware/custom.h" 

23 fcinclude "hardware/blit.h” 

24 #include "graphics/g-fxmacros. h" 

25 #include "graphics/copper.h" 

26 #include "graphics/view.h" 

27 #include “graphics/gels.h" 

28 #include "graphics/regions.h" 

29 #include "graphics/cllp.h" 

30 #include "graphics/text.h" 

31 #include "graphics/g-fxbase.h" 

32 #include "devices/keymap.h" 

33 #include "libraries/dos.h" 

34 #include "graphics/text.h" 

35 #include "intuition/intuition.h' 

36 4ine lüde "libraries/diskTont.h" 

37 

38 struct IntuitionBase «IntuitionBase; /* Lib - Zeiger #/ 

39 struct G-fxBase *GfxBase; 

40 

41 USHORT datalCD = /* Die verschiedenen Images %/ 

42 < 

43 0x03C0, OxOFFO, 

44 0xlFF8, 0x3FFC, 

45 0x7FFE, 0x7FFE, 

46 OxFFFF, OxFFFF, 

47 OxFFFF, OxFFFF, 

48 0x7FFE, 0x7FFE, 

49 0x3FFC, 0xlFF8, 

50 OxOFFO, 0x03C0, 

51 

52 


0 x0000, 0x0200. 
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53 

0x0200, 0x0400, 

54 

0x0400, 0x0800, 

55 

0x0800, 0 x 1000 , 

56 

0 x 1000 , 0x0800, 

57 

0x0800, 0x0400, 

58 

0x0400, 0x0200, 

59 

0 x 0200 , 0 x 0000 

60 

>; 

61 

62 

struct Image image 

63 

{ 

64 

o, 

65 

o, 

66 

16, 

67 

16, 

68 

2 , 

69 

&datalCO], 

70 

3, 

71 

0 , 

72 

NULL. 

73 

>; 

74 

75 

USHORT data2C] = 

76 

{ 

77 

0x03C0, OxOFFO, 

78 

0xlFF8, 0x3FFC, 

79 

0x7FFE, Ox7FFE, 

80 

OxFFFF, OxFFFF, 

81 

OxFFFF, OxFFFF, 

82 

Ox7FFE, 0x7FFE, 

83 

0x3FFC, 0xlFF8, 

84 

OxOFFO, 0x03C0, 

85 

86 

0 x 0000 , 0 x 0100 , 

87 

0 x 0100 , 0 x 0100 , 

88 

0 x 0100 , 0 x 0100 , 

89 

0 x 0100 , 0 x 0100 , 

90 

0x0080, 0x0080, 

91 

0x0080, 0x0080, 

92 

0x0080, 0x0080, 

93 

0x0080, 0x0080 

94 

>; 

95 

96 

struct Image image2 

97 

{ 

98 

o, 

99 

o, 

100 

16, 

101 

16, 

102 

2 , 

103 

&data2C0], 

104 

3, 

105 

o, 

106 

NULL 

107 

>; 

108 

109 

USHORT data3C] = 

110 

i 

111 

0x03C0, OxOFFO, 

112 

0xlFF8, Ox3FFC, 

113 

Ox7FFE, Ox7FFE, 

114 

OxFFFF, OxFFFF, 

115 

OxFFFF, OxFFFF, 

116 

Ox7FFE, 0x7FFE, 
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117 

0x3FFC, 

0xlFF8, 

118 

OxOFFO, 

0x03C0, 

119 



120 

0 x0000, 

0x0040, 

121 

0x0040, 

0 x0020, 

122 

0 x0020, 

0 x0010, 

123 

0 x0010, 

0x0008, 

124 

0x0008, 

0 x0010, 

125 

0 x0010, 

0 x0020 

126 

0 x0020, 

0x0040, 

127 

0x0040, 

0 x0000 


128 >; 

129 

130 struct Image image3 = 

131 < 

132 0, 

133 0, 

134 16, 

135 16, 

136 2, 

137 &data3C0], 

138 3, 

139 0, 

140 NULL 

141 ); 

142 

143 USHGRT bordataC ] = /* Die Border um das Feld #/ 

144 { 

145 0, 0, 

146 0, 200, 

147 190, 200, 

148 190 , 0, 

149 0, 0 

150 >; 

151 

152 struct Border border = 

153 { 

154 0, 

155 0, 

156 3, 

157 2, 

158 JAM1, 

159 5, 

160 &bordataC03, 

161 NULL 

162 >; 

163 

164 struct RastPort *rp; 

165 

166 struct NewScreen ns = /* Der eigene Screen */ 

167 < 

168 0 , 

169 0, 

170 320, 

171 256, 

172 2, 

173 0, 

174 1, 

175 0, 

176 CUSTÜMSCREEN, 

177 NULL, 

178 "Image'/Border-Demonstration", 

179 NULL, 
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180 NULL 

181 >; 

182 

183 

184 main() 

185 ( 

186 struct Screen *screen; 

187 LONG schleife; 

188 int x,y; 

189 

190 IntuitionBase = (struct IntuitionBase *) 

191 OpenLibrary(“intuition.library",0); 

192 if(IntuitionBase = NULL) exit(); /# oeffnen der Libs */ 

193 

194 GfxBase = (struct GfxBase *) 

195 OpenLibrary("graphics.library",0); 

196 if(GfxBase = NULL) exit(); 

197 

198 if ((screen = (struct Screen #) /% oeffnen des Screens */ 

199 QpenScreen(&ns)) — NULL) exitO; 

200 

201 rp = &screen->RastPort; 

202 /* Border zeichnen #/ 

203 for(schleife = 0; schleife < 6; schleife-*-*-) 

204 DrawBorder(rp,&border,70 + schleife,15 + schleife); 

205 

206 for(schleife = 0; schleife < 50; schleife++) /* Animation mit Images */ 

207 i /% durch verschiedene #/ 

208 for(x =0; x < 9; x-*-*-) /# Images %/ 

209 for(y = 0; y < 9; y+-*-) 

210 Drawlmage( rp,&imagel ,x * 20 -*- 80,y % 20 + 28); 

211 for(x =0; x < 9; x++) 

212 for(y = 0; y < 9; y++) 

213 Drawlmage(rp,&image2,x # 20+80,y* 20+28); 

214 for(x =0; x < 9; x++) 

215 for(y =0; y < 9; y++) 

216 Drawlmage(rp,&image3,x * 20 + 80,y * 20 + 28); 

217 >; 

218 

219 for(schleife = 0; schleife < 200000; schleife++); 

220 

221 CloseScreen(screen) ; 

222 CloseLibrary( IntuitionBase); 

223 CloseLibrary(GfxBase); 

224 > 


/* schllessen des Screens und der Libs */ 
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4.5 Intuition-Text 

Intuition stellt auch eine Funktion zur Verfügung, um Text auf den Bild¬ 
schirm zu bringen. Aber auch für eine Vielzahl anderer Anwendungen wird 
Intuition-Text benötigt, zum Beispiel für Menu’s. 

Als erstes muß eine IntuiText-Structure deklariert werden. Diese hat fol¬ 
gende Form: 

struct IntulText 
{ 

UBYTE FrontPen, BackPen; 

UBYTE DravMode; 

SHORT LeftEdge, TopEdge; 
struct TextAttr »ITextFont: 

UBYTE »IText; 

struct IntulText »NextText; 

): 

Die Angaben über die linke, obere Ecke geben die Position des ersten Zei¬ 
chens an, das ausgegeben werden soll. FrontPen gibt die Farbe an, in der der 
Text normalerweise geschrieben wird. Wird für DrawMode nicht JAM1, 
sondern JAM2 gewählt, so wird auch die Farbe, die mit BackPen angegeben 
ist, verwendet (nähere Angaben unter SetDrMd). Der Zeiger auf den Zei¬ 
chensatz, der verwendet werden soll, kann auf »NULL« gesetzt werden, 
wenn der eingestellte Zeichensatz verwendet werden soll. Der Zeiger auf 
den nächsten Text kann im Normalfall auf »NULL« gesetzt werden. 

Wie man zu der TextAttr-Structure für einen anderen Zeichensatz gelangt, 
ist unter den Text-Funktionen nachzulesen. 

Wir wollen nun also einen Text ausgeben. Dazu deklarieren wir eine 
IntuiText-Structure: 

struct IntulText text * 

{ 

2 , 

0 , 

JAM1, 


Farben für den Text 
Schrelb-Nodus 
Textposition 
Zelchensatz 
Auszugebender Text 
Zeiger auf nächsten Text 


50, 

NULL, 

"Text-Demonstration”, 
NULL 
>; 


Mit PrintIText(RastPort,&text,x,y); kann der Text nun einfach auf dem Bild¬ 
schirm ausgegeben werden. 
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RastPort ist ein Zeiger auf die RastPort-Structure des RastPorts, in den 
geschrieben werden soll, x und y geben die Position an, an der der Text 
geschrieben werden soll, x und y werden zu LeftEdge und TopEdge hinzu¬ 
addiert. 



5 


Einfache Animationen in 
Screens und Windows 


Das Amiga-System stellt eine Vielzahl von Animations-Möglichkeiten zur 
Verfügung. Diese reichen von den bekannten Sprites über AnimObjects bis 
hin zu den weniger bekannten Möglichkeiten durch Preferences und 
Playfields. Wie diese Möglichkeiten angewendet werden, möchten wir in die¬ 
sem Kapitel erläutern. 


Folgende Animationen stehen zur Verfügung: 


- Sprites: 


- VSprites: 


- Bobs: 


- AnimObjects: 


Einfache Sprites, wie sie auch von anderen 
Computern bekannt sind. Das Amiga-System 
unterstützt maximal 8 Hardware-Sprites, die 16 
Punkte breit und beüebig hoch sein dürfen. Dabei 
dürfen sie maximal 4 Farben enthalten, wobei eine 
»Farbe« durchsichtig ist. 

VSprites, oder auch virtuelle Sprites, sind ähnlich 
zu handhaben wie Hardware-Sprites, erlauben aber 
noch zusätzliche Abfragen, wie zum Beispiel die 
Kollisionsabfrage. VSprites sind im Prinzip auch 
Hardware-Sprites, da sie für die Darstellung auf 
diese zurückgreifen. 

Bobs, oder auch Blitter-Objekts, sind Software- 
Sprites, die direkt in den Screen gezeichnet werden. 
Dies vollzieht sich durch den Blitter zwar enorm 
schnell, aber sie sind doch langsamer als 
Hardware-Sprites, was besonders bei größeren 
Bobs deutlich wird. Sie unterliegen nur den Be¬ 
schränkungen des Screens. 

AnimObjects bestehen aus einer Vielzahl von 
VSprites und/oder Bobs, die in Folge gezeigt 
werden und so einen Bewegungsablauf suggerieren 
können. 
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- Maus: 


- Preferences: 


- Playfields: 


Für einfache Animationen kann auch der Maus¬ 
zeiger herangezogen werden. Durch SetPointer 
kann dieser verändert werden. 

Über Preferences kann der Bildschirm als Ganzes 
verschoben werden. 

Playfields ermöglichen zudem, Grafiken mit einer 
Auflösung von bis zu 1024 x 1024 Pixels zu ver¬ 
wenden, aus der aber immer nur ein Teil gezeigt 
wird. Durch Verschieben der Playfields kann 
ebenfalls Animation erzielt werden. 
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5.1 Einfache Hardware-Sprites 

Der Amiga stellt hardwaremäßig maximal 8 Sprites zur Verfügung. Diese 
Sprites dürfen 16 Punkte breit und beliebig hoch sein. Sie werden allerdings 
in der niedrigen Auflösung dargestellt, was auch dann gilt, wenn ein hoch¬ 
auflösender Screen verwendet wird. Ein Beispiel dafür ist der Mauszeiger, 
der nach dem Einschalten auf einem 640 x 256 Pixel-Screen gezeigt wird. 

Sprites dürfen bis zu 4 Farben verwenden, die aus den Screenfarbregistern 
entnommen werden. Folgende Sprite-Farbkombinationen sind vorhanden: 

Sprite 0 und 1 -> Farbregister 16 bis 19 

2 und 3 -> 20 bis 23 

4 und 5 -> 24 bis 27 

6 und 7 -> 28 bis 31 

Die Farbregister 16, 20, 24 und 28 haben allerdings keine Bedeutung, da die 
Sprite-Pixel, die auf diese Farbregister zugreifen, durchsichtig sind. Diese 
Farbregister gelten auch für Screens, die keine 32 Farben verwenden. Aus 
dieser Zuweisung folgt, daß einige Screenfarben unter Umständen mit den 
Spritefarben übereinstimmen, was aber bei geschickter Farbverteilung keine 
Einschränkung bedeuten sollte. 

Zudem haben die Sprites eine bestimmte Priorität, die nicht außer Kraft ge¬ 
setzt werden kann: 



Das bedeutet, daß Sprite 2 immer vor Sprite 4 erscheint, wenn sie sich über¬ 
lappen. 

Um ein Sprite auf den Schirm zu bekommen, muß als erstes in der 
NewScreen-Structure das Flag »SPRITES« gesetzt werden, was für den 
Workbench-Screen nicht nötig ist. Anschließend muß eine Spriteimage- und 
eine SimpleSprite-Structure initialisiert werden. Diese Structures haben fol¬ 
gende Form: 
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struct Spriteloage 

{ 

UWORD posctldata[2]; /* Positionskontrolle */ 

UWORD sprdata[2][height]; /* Spritedaten «/ 

UWORD reserved[2]; /* reserviert für spätere Anwendungen */ 


struct SimpleSprite 
{ 

UWORD »posctldata; 
UWORD helghtj 
UWORD x,y; 

UWORD nun; 

}; 


/* Zeiger auf Spritelmage-Structure */ 
/* Höhe des Sprites */ 

/* Position des Sprites */ 

/* Sprite-Nummer »/ 


Wie die SimpleSprite-Structure initialisiert wird, ist aus dem Demonstra¬ 
tionsprogramm ersichtlich. 

Auf die Spritelmage-Structure wollen wir hier etwas näher eingehen: 

Wir wollen ein Sprite initialisieren, das 5 Punkte hoch und 16 Punkte breit 
ist. Es soll ein Rechteck darstellen, dessen vier Seiten die vier Farben reprä¬ 
sentieren: 


1111111111111110 

1000000000000001 

erste 

erste 

Zelle 

Zelle 

- 0XFFFE 
* 0x8001 

1000000000000000 

1000000000000001 

zweite 

zweite 

Zeile 

Zeile 

* 0x8000 
- 0x8001 

1000000000000000 

1000000000000001 

usw. 


= 0x8000 
= 0x8001 

1000000000000000 

1000000000000001 



* 0x8000 
- 0x8001 

1000000000000000 

1000000000000001 



* 0x8000 
= 0x8001 

0 bedeutet Farbe 1 

0 (= durchsichtig) 

1 

0 bedeutet Farbe 2 

0 

1 bedeutet Farbe 

3 

1 

1 bedeutet Farbe 4 


Daraus ergibt sich folgende Spritelmage-Structure: 

struct Sprltelmage «Sprlrn « 

{ 

0,0, /* Positionskontroll-Bytes (immer 0) */ 

0XFFFE, 0x8001, /* Sprlte-Daten */ 

0x8000, 0x8001, 

0x8000, 0x8001, 

0x8000, 0x8001, 
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0x8000, 0x8001, 

0,0 /» Reserviertes Feld */ 

); 

Die Besitzer eines Amiga mit mehr als 512 KByte RAM müssen an dieser 
Stelle noch einen Zwischenschritt einlegen. Da die Custom-Chips des Amiga 
nur die unteren 512 KByte RAM ansprechen können, muß dafür gesorgt 
werden, daß die Sprite-Daten, sprich die Spritelmage-Structure, in eben 
diesen 512 KByte liegt. Dazu muß mit AllocMem Speicher zur Verfügung 
gestellt werden. Anschließend müssen die Sprite-Daten in diesen Bereich 
kopiert werden. Einfacher geschieht dies mittels eines »Schalters«, der beim 
Kompilieren gesetzt werden muß. Genaueres erfahren Sie in Ihrem C- 
Handbuch. 

Im Anschluß daran muß das Sprite mit GetSprite reserviert werden. Es ist 
aber noch nicht auf dem Bildschirm zu sehen. Erst wenn das Sprite mit 
MoveSprite an seine Position gebracht wird, wird es dargestellt. Ist trotzdem 
nichts zu sehen, so wurde wahrscheinlich vergessen, das Flag »SPRITES« in 
der NewWindow-Structure zu setzen, was aber auch nachträglich durch den 
Befehl ON SPRITE erreicht werden kann. 

Im Normalfall ist es allerdings nicht nötig, diese Flags zu setzen, da sie durch 
den Mauszeiger schon gesetzt werden. Wie dieser abgestellt werden kann, 
wird später erläutert. 

Mehr Informationen sind aus dem Demonstrationsprogramm ersichtlich. 


5.1.1 ChangeSprite 

Syntax: ChangeSprite(ViewPort,SpritePtr,SpriteImPtr); 

Funktion: Ändert ein Hardwaresprite, das zuvor mit GetSprite initiali¬ 

siert worden sein muß. 


Parameter: ViewPort -> Zeiger auf die ViewPort-Structure 

eines Screens. 

SpritePtr - > Zeiger auf die SimpleSprite-Structure. 

SpritelmPtr -> Zeiger auf die Spritelmage-Structure. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct ViewPort *ViewPort; 

struct SimpleSprite *SpritePtr; 
struct Spriteimage *SpriteImPtr; 
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Sonstiges: Auf den ViewPort kann man auf verschiedene Arten zugrei¬ 

fen: 

Vom Window: WindowPtr - > WScreen - > ViewPort 
Vom Screen: ScreenPtr -> ViewPort 

Der ViewPort muß zu dem Screen gehören, auf dem die 
Sprites dargestellt werden sollen. 

Der SpritePtr ist noch vom GetSprite-Befehl vorhanden. 

Der SpritelmPtr muß neu erstellt werden, da er die neuen 
Daten für das Sprite enthält. Man kann hier auch die 
Spritelmage-Structure aus der SimpleSprite-Structure ver¬ 
wenden, auf die der SpritePtr zeigt. 

Sie finden diesen Aufbau wahrscheinlich sehr kompliziert. In 
diesem Fall empfehlen wir Ihnen, die Beispiele genau zu be¬ 
trachten. Wir sind sicher, daß Ihnen der Aufbau und die 
Logik dann um einiges klarer ist. 

Ob für die Sprite-Daten nun 
struct Spriteimage *SpriteImPtr; 

oder 

USHORT SpriteImPtr[]; 
verwendet wird, ist unerheblich. 

Referenz: Für die SimpleSprite- und die Spritelmage-Structure siehe 

auch Kapitel 5.1 »Einfache Hardware-Sprites«. 


5.1.2 FreeSprite 


Syntax: 

FreeSprite(SpriteNr); 

Funktion: 

Löscht ein Hardwaresprite vom Screen. 

Parameter: 

SpriteNr -> Hardwaresprite von 0 bis 7. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

int SpriteNr; 

Sonstiges: 

Dieser Befehl sollte immer dann angewendet werden, wenn 
ein Sprite nicht mehr benötigt wird, da das Amiga-System nur 
8 Hardware-Sprites zur Verfügung stellt und somit nur allzu 
schnell alle Sprites belegt sind. 
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5.1.3 


GetSprite 


Syntax: 

Funktion: 

Parameter: 

Ergebnis: 

Datentyp: 

Sonstiges: 


Referenz: 


SpriteNrl = GetSprite(SpritePtr,SpriteNr2); 

Reserviert ein Hardwaresprite. 

SpritePtr -> Zeiger auf die SimpleSprite-Structure. 

SpriteNr2 - > Hardwaresprite, das zu setzen ist. 

SpriteNrl -> Hardwaresprite, das gesetzt wurde. 

struct SimpleSprite *SpritePtr; 
int SpriteNr2; 
int SpriteNrl; 

Wird SpriteNr2 gleich -1 gesetzt, wird das nächste freie Sprite 
benutzt und die entsprechende Nummer zurückgegeben. 
Wird für SpriteNr2 eine Nummer von 0 bis 7 übergeben, so 
wird das entsprechende Sprite gesetzt und die Nummer wie¬ 
der zurückgegeben. 

Ein Sonderfall tritt ein, wenn alle Sprites belegt sind, bzw. 
wenn das gewünschte Sprite besetzt ist. In diesem Fall wird 
der Wert -1 zurückgegeben und es wird kein Sprite gesetzt. 

Wenn das Sprite gesetzt wurde, wird die Nummer in die 
SimpleSprite-Structure eingetragen und zudem über 
SpriteNrl zurückgegeben. 

WICHTIG! Dieser Befehl stellt das Sprite noch nicht auf 
dem Bildschirm dar. Erst wenn es mit MoveSprite positio¬ 
niert worden ist, ist es zu sehen. 

Für die SimpleSprite-Structure siehe Kapitel 5.1 »Einfache 
Hardware-Sprites«. 


5.1.4 MoveSprite 

Syntax: MoveSprite(ViewPort,SpritePtr,x,y); 

Funktion: Bewegt ein Hardware-Sprite zu einer spezifizierten Position 

und stellt es dort dar. 

Parameter: ViewPort -> Zeiger auf die ViewPort-Structure 

eines Screens. 

SpritePtr -> Zeiger auf die SimpleSprite-Structure 

des Sprites, das bewegt werden soll. 
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x,y -> geben die neue Sprite-Position relativ 

zur linken, oberen Ecke des Screens 



an. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct ViewPort *ViewPort; 
struct SimpleSprite *SpritePtr; 
int x, y; 


Sonstiges: 

Wie schon zuvor erwähnt, sind Sprites immer in der niedrigen 
Auflösung sichtbar. Das bedeutet, daß sie auf einem 640x400 
Screen nur um jeweils zwei Punkte in jede Richtung bewegt 
werden können. 



Wird dieser Befehl mit ChangeSprite kombiniert, so können 
schon einfache Trickfilme erstellt werden. 

5.1.5 

OFFSPRITE 


Syntax: 

OFF_SPRITE(); 


Funktion: 

Stellt den Sprite-DMA-Kanal ab. 


Parameter: 

Keine Parameter. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

Keine Variablen. 


Sonstiges: 

Dieser Befehl bewirkt die Sperrung des Sprite-DMA-Kanals, 
was zur Folge hat, daß kein Sprite mehr sichtbar ist. 



WICHTIG! OFF SPRITE ist ein Macro und muß speziell 
eingeladen werden. Siehe dazu den Anhang. 


Referenz: 

Siehe auch ON SPRITE 

5.1.6 

ON SPRITE 


Syntax: 

ON_SPRITE(); 


Funktion: 

Stellt den Sprite-DMA-Kanal an. 


Parameter: 

Keine Parameter. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

Keine Variablen. 
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Sonstiges: Dieser Befehl bewirkt das Einschalten des Sprite-DMA- 

Kanals, was zur Folge hat, daß alle Sprites, die zuvor mit 
GetSprite initialisiert worden sind, sichtbar werden. Im Nor¬ 
malfall muß dieser Befehl nicht verwendet werden. 

WICHTIG! ONSPRITE ist ein Macro und muß speziell 
eingeladen werden. Siehe dazu den Anhang. 

Referenz: Siehe auch OFF SPRITE 
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1 /******************************* 

2 

3 Sprite / Demonstration 

4 last update 26/06/87 

5 von Joerq Koch und Frank Kremser 

6 (c) Markt & Technik 1987 

7 

0 ******************************** 

9 

10 Sprite-Demo laesst 4 bunte Smiles ueber den Screen flitzen, die sich 

11 in der mitte >Guten Taq< saqen. 

12 

13 *******************************/ 

14 

15 #include <exec/types.h> /% Include-Files die wir brauchen */ 

16 #include <exec/tasks.h> 

17 #include <exec/libraries.h> 

18 #include <exec/memory.h> 

19 ttinclude <exec/devices.h> 

20 #include <devices/keymap.h> 

21 #include <graphics/copper.h> 

22 #include <graphics/display.h> 

23 #include <graphics/gfxbase.h> 

24 #include <graphics/text.h> 

25 #include <graphics/view.h> 

26 #include <graphics/qels.h> 

27 #include <graphics/regions.h> 

28 #include <graphics/sprite.h> 

29 #include <hardware/blit.h> 

30 #include <intuition/intuition.h> 

31 #include <intuition/intuitionbase.h> 

32 

33 

34 struct GfxBase *GfxBase; /* Lib Zeiqer */ 

35 struct IntuitionBase *IntuitionBase; 

36 

37 struct Screen #screen; /* Screen - Structure */ 

38 

39 USHDRT DatalCD = 

40 ( /* Sprite Daten */ 


41 

O 

O 


42 



43 

OxOFCO, 

OxOFCO 

44 

0x3FF0, 

0x3030 

45 

0x7FF8, 

0x4008 

46 

0x7FF8, 

0x4008 

47 

0xF33C, 

0x8CC4 

48 

OxFFFC, 

0x8004 

49 

OxFFFC, 

0x8004 

50 

OxFCFC, 

0x8304 

51 

OxFFFC, 

0x8004 

52 

OxFFFC, 

0x9024 

53 

0x7FF8, 

0x4848 

54 

0x7FF'8, 

0x4788 

55 

0x3FF0, 

0x3030 

56 

OxOFCO. 

OxOFCO 

57 



58 

0,0 



59 >; 

60 

61 USHGRT Data2L J = 

62 ( 

63 0, 0, 

64 


/* Sprite Daten */ 
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65 

OxOFCO 

OxOFCO 

66 

Ox3FFO 

0x3030 

67 

0x7FF8 

0x4008 

68 

0x7FF8 

0x4008 

69 

0xF33C 

0x8CC4 

70 

OxFFFC 

0x0004 

71 

OxFFFC 

0x8004 

72 

OxFCFC 

0x8304 

73 

OxFFFC 

0x8004 

74 

OxFFFC, 

0x9024 

75 

0x7FF8, 

0x4848 

76 

Ox7FF8, 

0x47^8, 

77 

0x3FF0, 

0x3030, 

78 

OxOFCO, 

OxOFCO, 

79 

00 

0,0 


81 

); 


82 

83 

USHURT Data3C J = 

84 

< 


85 

0 , 0 , 


86 

87 

OxOFCO, 

OxOFCO, 

88 

0x3FF0, 

0x3030, 

89 

Ox 7FF8, 

0x4008, 

90 

0x7FF8, 

0x4008, 

91 

OxF33C, 

0x8CC4, 

92 

OxFFFC, 

0x8004, 

93 

OxFFFC, 

0x8004, 

94 

OxFCFC, 

0x8304, 

95 

OxFFFC, 

0x0004, 

96 

OxFFFC, 

0x9024, 

97 

0x7FF8, 

0x4848, 

98 

0x7FF8, 

0x4788, 

99 

0x3FF0, 

0x3030, 

100 

OxOFCO, 

OxOFCO, 

101 

102 

0,0 


103 

>; 


104 

105 

USHORT Data4C J = 

106 

{ 


107 

d 


108 

109 

OxOFCO, 

OxOFCO, 

110 

0x3FF0, 

0x3030, 

111 

0x7FF8, 

0x4008, 

112 

Ox7FF8, 

0x4008, 

113 

0xF33C, 

Ox8CC4, 

114 

OxFFFC, 

0x8004, 

115 

OxFFFC, 

0x8004, 

116 

OxFCFC, 

0x8304, 

117 

OxFFFC, 

0x0004, 

118 

OxFF FC, 

0x9024, 

119 

Ox7FF8, 

0x4848, 

120 

0x7FF8, 

0x4788, 

121 

Ox3FFO, 

0x3030, 

122 

OxOFCO, 

OxOFCO, 

123 

124 

0,0 



125 >; 

126 

127 struct SimpleSprite spritel 

128 { 


/* Sprite Daten */ 


/* Sprite Daten */ 


/* Structure initialisieren #/ 
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129 

&DatalCOT, 




130 

14, 


/* Hoehe #/ 


131 

100, 


/* X - Position 

*/ 

132 

100, 


/% Y - Position 

#/ 

133 

2 


/# Sprite Nummer 

*/ 

134 

>; 




135 





136 

struct SimpleSprite sprite2 = 




137 

{ 




138 

&Data2C0D, 




139 

14, 




140 

100, 




141 

100, 




142 

2 




143 

>; 




144 





145 

struct SimplpSpnte sprite3 = 




146 

C 




147 

&Data3C03, 




148 

14, 




149 

100, 




150 

100, 




151 

2 




152 

>; 




153 





154 

struct SimpleSprite sprite4 = 




155 

{ 




156 

&Data4C03, 




157 

14, 




158 

100, 




159 

100, 




160 

2 




161 

>: 




162 





163 

struct NewScreen ns = 

/* 

Die New-Screen Struktur 

164 

< 




165 

o, 

/% 

Linke Ecke */ 


166 

0, 

/* 

Obere Ecke */ 


167 

320, 

/% 

Breite %/ 


168 

256, 

/% 

Hoehe %/ 


169 

2, 

/% 

Tiefe %/ 


170 

0, 

/% 

DetaiIPen */ 


171 

1, 

/% 

BlockPen */ 


17? 

SPRITES, 

/* 

ViewModes */ 


173 

CUSTOMSCREEN, 

/% 

Type %/ 


174 

NULL, 




175 

NULL, 




176 

NULL , 




177 

NULL 




178 

>; 




179 





180 





181 

main< ) 




182 

( 




183 

LONG warte; 




184 

USHÜR1 schleife; 




185 





186 

/# oeffnen der Libs %/ 




187 

lf ((Intuitionöase = (struct IntuitionBase *) 


188 

OpenLibrary("Intuition.library". 

, 0)) 

== 0) exit(); 


189 





190 

lf <(Gfxbase = (struct GfxBase 

«) 



191 

OpenLibrary("qraphics.library", 

0)) - 

= 0) exit(); 


192 


/* 

oeffnen des Screens */ 
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193 l-f ((screen = (struct Sc r een* ) OpenScreen (&ns)) = NULL) exi t < ); 

194 

195 SetRGB4(&screen->ViewPort,20,9,9,9); /* Farben setzen */ 

196 SetRGB4(&screen->ViewPort,21,11,11,11); 

197 SetRGB4(&screen->ViewPort,22,13,13,13); 

198 SetRGB4(&sc reen->ViewPor t,23,15,15,15); 

199 SetRGB4(&screen->ViewPort,24,15,0,0); 

200 SetRGB4(&screen->ViewPort,25,0,15,0); 

201 SetRGB4(&screen->ViewPort,26,0,0,15); 

202 SetRGB4(&screen->0iewF>ort,27,15,0,15); 

203 

204 schleife = GetSprite(&spn tel ,3); /* Sprite holen %/ 

205 schleife = GetSprite(&sprite2,4); 

206 schleife = GetSprite(&sprite3,5); 

207 schleife = GetSprite(&sprite4,6); 

200 

209 /* Sprites ueber den Screen bewegen */ 

210 for (schleife = 0; schleife < 240; ++schleife) 

211 { 

212 for (warte = 0; warte <1000; ++warte); 

213 MoveSprite(&screen->ViewPort, &spntel, schleife, schleife); 

214 MoveSpr i te(&screen->ViewPort, &spnte2, 320-schleife, schleife); 

215 MoveSprite(&screen->ViewPort, &sprite3, schleife, 256-schleife); 

216 MoveSprite(&screen->ViewPort, &sprite4, 320-schleife, 256-schleife); 

217 > 

218 for(warte = 0; warte < 500000; ++warte); 

219 

220 FreeSprite(3); /* Sprites loeschen %/ 

221 FreeSpr i te(4); 

222 FreeSprite(5); 

223 F reeSpr i te(6); 

224 

225 CloseScreen(screen); 

226 C1oseLlbrary(Gf xBase); 

22/ CloseLibrary(IntuitionBase); 

228 > 


/* Screen und Libs */ 
/# sc hl i essen */ 
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5.2 VSprites 

VSprites, oder auch virtuelle Sprites, sind im Prinzip nicht anderes als 
Hardware-Sprites mit einer veränderten Handhabung. Ihr Vorteil liegt darin, 
daß sie die größte Schwäche von Hardware-Sprites umgehen: Es können 
mehr als nur 8 Sprites verwendet werden. Der Trick, der bei VSprites ange¬ 
wendet wird, um dies mit den Hardware-Sprites zu erreichen, besteht darin, 
daß Sprites mehrmals dargestellt werden und zwar mit verschiedenen Daten. 
Dazu muß aber zwischen der ersten und der zweiten Darstellung mindestens 
eine Bildschirmzeile liegen, da sonst die Hardware nicht mehr mitspielt. 

Das Ganze sieht dann folgendermaßen aus: 


Sprite 2 


mindestens eine Bildschirmzelle 


Sprite 2 


Sprite 3 


Um das Handling braucht sich der Programmierer glücklicherweise nicht zu 
kümmern, dafür müssen bei Verwendung der VSprites aber einige Para¬ 
meter mehr übergeben werden. 

Für Breite, Höhe und Farbanzahl gelten logischerweise die gleichen 
Beschränkungen, wie für Hardware-Sprites. Das heißt, sie sind 16 Punkte 
breit und bis zu 320 Punkte hoch, da Sprites immer in der niedrigen Auf¬ 
lösung gezeichnet werden. Sie dürfen maximal 4 Farben verwenden, wobei 
Farbe 1, wie bei den Hardware-Sprites, durchsichtig ist. 

Hier ist aber ein weiterer Vorteil der VSprites gegenüber den Hardware- 
Sprites zu entdecken: jedes VSprite hat seine eigenen 3 Farben, in denen es 
dargestellt wird. 

Folgendermaßen wird ein VSprite initialisiert: 

Zuerst muß eine VSprite-Structure erstellt werden. Diese hat folgendes Aus¬ 
sehen: 

struct VSprltet 

struct VSrlte «NextVSprite; /* Nur für das System */ 

struct VSrlte «PrevVSprlte; 
struct VSrlte «DravPath; 
struct VSrlte »ClearPath; 

WORD OldY.OldX; 

WORD Flags; /* Folgende Flags sind möglich: 
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VSPRITE: Dieses Flag muß hier immer gesetzt 

werden, da wir an dieser Stelle nur 
VSprites verwenden. Nur wenn Bob’s 
verwendet werden, ist dieses Flag nicht 
zu setzen. 


VSOVERFLOW: Dieses Flag kann nicht vom Pro¬ 

grammierer gesetzt werden, sondern 
nur gelesen werden. Ist es dann gesetzt, 
können nicht alle VSprites gezeigt 
werden, da sich zu viele überlappen. 

GELGONE: Auch dieses Flag kann nur gelesen 

werden. Ist dieses Flag gesetzt, bedeu¬ 
tet dies, daß mindestens ein VSprite 
außerhalb des Screens positioniert ist. 


WORD Y,X; 

WORD Helght; 

WORD Uldth; 

WORD Depth; 

WORD MeMask; 

WORD Hitdask: 

WORD »ImageData; 

WORD »BorderLlne; 
WORD »CollMask; 

WORD »SprColors; 
struct Bob *VBob; 
BYTE PlanePick; 

BYTE PlaneOnOff; 
VUserStuff VUserExt; 

): 


/* VSprite-Position */ 

/* Höhe von 0 bis 256 Pixels */ 

/* wird ignoriert */ 

/» wird ignoriert */ 

/* für Kollisionsabfrage */ 

/» für Kollisionsabfrage */ 

/* Zeiger auf Sprltedaten, die wie die Daten für 
ein Hardware-Sprite ermittelt werden */ 

/* für Kollisionsabfrage */ 

/* für Kollisionsabfrage */ 

/» VSprite-Farben */ 

/* wird Ignoriert */ 

/* wird ignoriert »/ 

/* wird Ignoriert */ 

/* für Benutzer-Anwendungen */ }; 


Viele der Parameter sind mit /»wird ignoriert*/ gekennzeichnet. Diese 
Parameter werden nur in Verbindung mit Bob’s benötigt. Die Parameter für 
die Kollisionsabfrage lassen wir an dieser Stelle außer Acht, da dies ein wei¬ 
terführendes Thema ist. 

Wie das Structure initialisiert werden kann, ist aus der Demonstration er¬ 
sichtlich. 
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Zu Beginn des Programms muß einmal das GEL-System (»Graphic 
Elements List«) installiert werden, wobei zum einen eine leere Gelslnfo- 
Structure mit einigen Daten belegt werden muß. Welche belegt werden müs¬ 
sen, ist aus dem Demonstrationsprogramm ersichtlich. Anschließend muß sie 
mit InitGels installiert werden. Nach der Installation können dann die 
VSprites mit AddVSprite gesetzt werden. Ändern kann man sie, indem die 
VSprite-Structure geändert wird. Um das Sprite schließlich darzustellen, 
müssen folgende Befehle ausgeführt werden: 

- ON DISPLAY und ON SPRITE um die DMA-Kanäle einzuschalten. 
(Ist im Normalfall nicht nötig) 

- SortGList um die VSprites zu sortieren. 

- DrawGList um die Liste bereitzustellen. 

- MrgCop um die Liste dem Copper zur Verfügung zu stellen. 

- LoadView um die Daten schließlich darzustellen. 

Näheres ist aus den nachfolgenden Befehlserläuterungen und dem Demon¬ 
strationsprogramm ersichtlich. 


5.2.1 


AddVSprite 


Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


AddVSprite(Sprite,RastPort); 

Dieser Befehl fügt ein VSprite, das durch die VSprite- 
Structure festgelegt ist, in die VSprite-Liste ein. 

Sprite -> ist der Zeiger auf die VSprite-Structure 

des VSprites, das gezeigt werden soll. 

RastPort -> ist ein Zeiger auf die RastPort- 

Structure des Screens oder Windows, 
das die VSprites kontrollieren soll. 

Kein Ergebnis. 

struct VSprite "“Sprite; 
struct RastPort "RastPort; 

Der Zeiger auf den RastPort ist der Window- oder der 
Screen-Structure zu entnehmen, was folgendermaßen ge¬ 
schieht: 


Window: WindowPtr -> RPort 

Screen: ScreenPtr -> RastPort 
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Die VSprite-Structure ist schon zuvor erläutert worden. 
Nähere Informationen über die Verwendung von VSprites 
entnehmen Sie bitte dem Demonstrationsprogramm. 


5.2.2 DrawGList 


Syntax: 

Funktion: 


Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


DrawGList(RastPort, ViewPort); 

Bereitet die VSprite-Liste für die Verwendung durch den 
Copper vor und stellt den benötigten Speicherplatz zur Ver¬ 
fügung 

RastPort -> Zeiger auf die RastPort-Structure, die 

die VSprites kontrolliert (siehe auch 
AddVSprite) 

ViewPort -> Zeiger auf die ViewPort-Structure des 

Screens, auf dem die VSprites darge¬ 
stellt werden sollen. 

Kein Ergebnis. 

struct RastPort *RastPort; 
struct ViewPort *ViewPort; 

Dieser Befehl wird auch für die Verwendung von Bob’s 
benötigt. In diesem Zusammenhang hat er noch andere 
Funktionen, doch da wir in diesem Kapitel nur auf VSprites 
eingehen wollen, lassen wir die zusätzlichen Funktionen 
außer Acht. 


Wie auf den RastPort zugegriffen werden kann, ist unter 
AddVSprite erläutert. Auf den ViewPort kann man folgen¬ 
dermaßen zugreifen: 

Vom Window: WindowPtr-> WScreen-> ViewPort 
Vom Screen: ScreenPtr-> ViewPort 
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5.2.3 InitGels 

Syntax: InitGels(VSpritel,VSprite2,gelsinfo); 

Funktion: Initialisiert eine Grafikelement-Liste, in die die VSprites ein¬ 

getragen werden. 


Parameter: VSpritel 

-> ist ein Zeiger auf eine leere VSprite- 
Structure, die den Anfang der Liste re¬ 
präsentiert. 

VSprite2 

-> ist ein Zeiger auf eine leere VSprite- 
Structure, die das Ende der Liste re¬ 
präsentiert. 

gelsinfo 

-> ist ein Zeiger auf eine leere Gelslnfo- 
Structure, die initialisiert werden soll. 


Ergebnis: Kein Ergebnis. 

Datentyp: struct VSprite *VSpritel, *VSprite2; 

struct Geisinfo *gelsinfo; 

Sonstiges: Wichtig! Dieser Befehl muß auf jeden Fall einmal aufgerufen 

werden, wenn VSprites benutzt werden sollen. Der Aufruf 
braucht nur einmal zu geschehen, muß vor dem ersten 
AddVSprite-Befehl stehen, weshalb er am Besten an den 
Anfang des Programms gesetzt wird. 

Die VSprite-Structures, auf die VSpritel und VSprite2 zei¬ 
gen, sollten keine wichtigen Daten enthalten, da sie nur zur 
Erkennung des Beginns und des Endes der Liste dienen. 

Die Gelslnfo-Structure muß keine Werte enthalten, da diese 
von InitGels gesetzt werden. Folgendermaßen kann die 
Gelslnfo-Structure deklariert werden: 

struct Geisinfo *gelsinfo; 

Nun kann gelsinfo, wie unter Syntax zu sehen ist, verwendet 
werden. 

Da die Gelslnfo-Structure keine besondere Bedeutung für 
den Programmierer hat, führen wir sie hier nicht auf. Sollten 
Sie trotzdem Interesse an dieser Structure haben, verweisen 
wir Sie auf den Anhang. 
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5.2.4 LoadView 

Syntax: LoadView(view); 

Funktion: Stellt auf dem Bildschirm die Informationen dar, wie sie in 

den Copper-Instruktionen festgelegt sind. 

Parameter: view -> Zeiger auf eine View-Structure, die 

einen Zeiger auf die Copper-Instruk- 
tions-Liste besitzt. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct View *view; 

Sonstiges: Dieser Befehl muß verwendet werden, um VSprites sichtbar 

zu machen, die mit AddVsprite in die VSprite-Liste eingetra¬ 
gen worden sind. Welche Befehle dazu noch zu verwenden 
sind, ersehen Sie aus Kapitel 5.2 »VSprites« und aus dem 
Demonstrations-Programm. 

Auf die View-Structure kann folgendermaßen zugegriffen 
werden: 

LoadView(ViewAddressQ); 

5.2.5 MrgCop 

Syntax: MrgCop(view); 

Funktion: Trägt die nötigen Informationen, die der Copper benötigt, um 

die VSprites darzustellen, in die Copper-Instruktionsliste ein. 

Parameter: view -> Zeiger auf eine View-Structure, in die 

neue Copper-Instruktionen eingefügt 
werden sollen. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct View *view; 

Sonstiges: Auf die View-Structure kann folgendermaßen zugegriffen 

werden: 


MrgCop(ViewAddressQ); 
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5.2.6 

InitMasks 



Syntax: 

InitMaks(VSprite); 


Funktion: 

Dieser Befehl setzt die Umrandungen des VSprites und die 
dazugehörigen Kollisions-Masken. 


Parameter: 

VSprite -> Zeiger auf die VSprite-Structure des 

VSprites, dessen Kollisions-Maske 
gesetzt werden soll. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct VSprite “VSprite; 


Sonstiges: 

Dieser Befehl erleichtert die Gestaltung der Kollisionsabfrage 
enorm. Er ermittelt die äußersten Punkte des VSprites und 
trägt die entsprechenden Daten in die VSprite-Structure ein. 

5.2.7 

RemVSprite 


Syntax: 

RemVSprite(VSprite); 


Funktion: 

Entfernt ein VSprite aus der Liste. 


Parameter: 

VSprite -> Zeiger auf die VSprite-Structure des 

VSprites, das gelöscht werden soll. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct VSprite “VSprite; 


Sonstiges: 

Das VSprite kann anschließend einfach mit AddVSprite 
erneut in die Liste eingetragen werden. 

5.2.8 

SortGList 



Syntax: 

SortGList(RastPort); 


Funktion: 

Sortiert die VSprite-Liste. 


Parameter: 

RastPort -> Zeiger auf die RastPort-Structure, die 

die VSprites kontrolliert. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct RastPort “RastPort; 
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Sonstiges: 

Dieser Befehl sortiert die VSprite-Liste nach Y-Koordinaten. 
Das bedeutet, VSprites, die weiter oben erscheinen sollen, 
sind auch in der Liste weiter vorne zu finden. Dies ist nötig, 
um möglichst schnell zwischen zwei Bilddaten für die 
Hardware-Sprites, die ja zur Darstellung der VSprites ver¬ 
wendet werden, umschalten zu können. 

Auf den RastPort kann man entweder über ein Window oder 
über einen Screen zugreifen. Dies geschieht folgendermaßen: 

- Window: WindowPtr->RPort 

- Screen: ScreenPtr- > RastPort 

5.2.9 WaitTOF 

Syntax: 

WaitTOF(); 

Funktion: 

Wartet, bis der Elektronenstrahl der Bildröhre an der oberen 
Kante eines Screens angelangt ist. 

Parameter: 

Keine Parameter. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

Keine Variablen. 

Sonstiges: 

Ist nur ein Screen auf dem Bildschirm zu sehen, wartet 
WaitTOF, bis der Elektronenstrahl am oberen Ende des 
Screens angelangt ist. 

Dieser Befehl wird verwendet, um daß Programm mit dem 
Elektronenstrahl zu synchronisieren. 
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1 /M**M*******************M**** 

2 

3 VSprite-Demonstration 

4 last update 26/06/8/ 

b von Joerq Koch und Frank Kremser 

6 (C) Markt & lechnik 198/ 

7 

H *#**M*M#**^******************# 

9 

10 Diese Demonstrat lon verwendet 12 V/Spntes, wovon eines quer ueber 

11 den Bildschirm beweqt wird 

12 

13 %%%%%%%%%%%%%%%%%%%%/ 

14 

1b «include <exec/types.h> /* Include-Files laden */ 

16 «inclüde <exec/tasks.h> 

1/ «include <exec/1ibraries.h> 

18 «include <exec/exec.. h> 

19 «inclüde <.exec/devices.h> 

20 «mclude <devices/keymap.h> 

21 «inrlude <graphics/copper.h> 

22 ttinclude <qraphics/display.h> 

23 «include <graphics/g-f xbase.h> 

24 «include <graphics/text.h> 

25 «include <graphics/view.h> 

26 «include <graphics/qels.h> 

27 «include <graphics/regions.h> 

28 «include <graphics/spnte.h> 

29 «include <hardware/blit.h> 

30 «include <intuition/intuition.h> 

31 «include <intuition/intuitionbase.h> 

32 

33 

34 struct 6-fxBase *l3fxBase; /* Library-Zeiger */ 

35 struct IntuitionBase *IntuitionBase; 

36 

37 struct Screen *screen; /* Screen-Zeiger #/ 

38 struct RastPort #rp; /% RastPort-Zeiqer */ 

39 

40 struct V/Spnte VSl, V/S2; /* VSpnte-Zeiger */ 

41 

42 WURD spritecolorslLJ = i 0x0000, 0x0888, OxOFFF >; /# Sprite+arben %/ 

43 WURD spritecolors2[] = < 0x0900, 0x0800, OxOFOO >; 

44 WURD spntecolors3C D = { 0x0090 , 0x0040, OxOOFO >; 

4b WORD spritecolors4[D = { 0x0009, 0x0383, OxOFFO >; 

46 WURD spn tecolorsSC ] = ( 0x0000, 0x0888, 0x0F8F ); 

47 WURD spntecolors6C] = ( 0x0000, 0x0768, 0x07F0 >; 

48 WURD spntecolors7CD = < 0x0000, 0x0848, OxOFOF }; 

49 WURD spritecolors8C] = { 0x0000, 0x0505, 0x045F >; 

50 WURD sprltecolors9C J = { 0x0000 , 0x0800 , 0x0O6F >; 

51 WURD spritecolorslOC] = { 0x0000, 0x0808, 0x0F30 >; 

52 WURD spntecolorsl1C3 = { 0x0000, 0x0089, OxOOF8 >; 

53 WURD spritecolorsl2CJ = ( 0x0000, 0x0208, 0x03F4 >; 

54 

55 USHURT DataC] = /* Ein Spriteimage fuer alle Sprites 

56 C 

57 OxOFCO, OxOFCO, 

58 0x3FF0, 0x3030, 

59 Ox7FF8, 0x4008, 

60 Ox 7FF8 , 0x4008, 

61 0xF33C, 0x8CC4, 

62 OxFFFC, 0x8004, 

63 OxFFFC, 0x8004, 

64 OxFCFC, 0x8304, 
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65 OxFFFC, 0x0004, 

66 OxFFFC, 0x9024, 

67 0x7FF8, 0x4848, 

68 0x7FF8, 0x4788, 

69 Ox3FFO, 0x3030, 

70 OxOFCO, OxOFCO 

71 >; 

72 

73 struct VSpnte spntel = /* Sprites deklarieren */ 

74 ( 

75 Mil, 

/6 NULL, 

77 NULL, 

78 NULL, 

79 0, 

80 0, 

81 VSPRITE, 

82 50, 

83 50, 

84 14, 

85 14, 

86 0 , 

87 0, 

88 0 , 

89 ÄDataCO], 

90 NULL, 

91 NULL, 

92 &spritecolorslCO], 

93 NULL, 

94 0, 

95 0 

96 >; 

97 

98 struct VSpnte sprite2 = 

99 C 

100 NULL, 

101 NULL, 

102 NULL, 

103 NULL, 

104 0, 

105 0, 

106 VSPRITE, 

107 100, 

108 100, 

109 14, 

110 14, 

111 0 , 

112 0, 

113 0, 

114 ADataCO], 

115 NULL, 

116 NULL, 

117 &spn tecolors2C0], 

118 NULL, 

119 0, 

120 0 

121 >; 

122 

123 struct VSpnte spnte3 = 

124 ( 

125 NULL, 

126 NULL, 

127 NULL, 

128 NULL, 
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129 0, 

130 0, 

131 VSPRITE, 

132 150, 

133 150, 

134 14, 

135 14, 

136 0, 

137 0, 

138 0, 

139 ÄDataCO], 

140 NULL, 

141 NULL, 

142 &spn tecolors3C0], 

143 NULL, 

144 0, 

145 0 

146 >; 

147 

148 struct VSpnte sprite4 = 

149 ( 

150 NULL, 

151 NULL, 

152 NULL, 

153 NULL, 

154 0, 

155 0, 

156 VSPR1TE, 

157 100, 

158 200, 

159 14, 

160 14, 

161 0, 

162 0, 

163 0, 

164 &DataLOJ, 

165 NULL, 

166 NULL, 

167 &spritecolors4C03, 

168 NULL, 

169 0, 

170 0 

171 >; 

1/2 

173 struct VSprite spriteS = 

174 { 

175 NULL., 

1 76 NULL, 

177 NULL, 

1 78 NULL, 

1/9 O, 

180 O, 

181 VSPRITE, 

182 20, 

183 10, 

184 14, 

185 14, 

186 0, 

187 0, 

188 0, 

189 &DataCOJ, 

190 NULL, 

191 NULL, 

192 &spritecolorsSCOD, 
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193 NULL, 

194 0, 

195 0 

196 >; 

197 

198 struct VSprite sprite6 = 

199 { 

200 NULL, 

201 NULL, 

202 NULL, 

203 NULL, 

204 0, 

205 0, 

206 VSPRITE, 

207 30, 

208 300, 

209 14, 

210 14, 

211 0 , 

212 0 , 

213 0, 

214 &DataC0J, 

215 NULL, 

216 NULL, 

217 &spritecolors6C0J, 

21B NULL, 

219 0, 

220 0 

221 >; 

222 

223 struct VSpnte spnte7 = 

224 < 

225 NULL, 

226 NULL, 

227 NULL, 

228 NULL, 

229 0, 

230 0, 

231 VSPRITE, 

232 190, 

233 160, 

234 14, 

235 14, 

236 0, 

237 0, 

238 0, 

239 &DataC03, 

240 NULL, 

241 NULL, 

242 &spr i teco1ors7 C 0 D, 

243 NULL, 

244 0, 

245 0 

246 >; 

247 

248 struct VSprite sprite8 = 

249 t 

250 NULL, 

251 NULL, 

252 NULL, 

253 NULL, 

254 0, 

255 0, 

256 VSPRITE, 




164 Einfache Animationen in Screens und Windows 


257 80, 

258 70, 

259 14, 

260 14, 

261 0, 

262 0, 

263 0, 

264 &DataL0D, 

265 NULL, 

266 NULL, 

267 &spntecolors8L0J, 

268 NULL, 

269 0, 

270 0 

271 ); 

272 

273 struct VSpnte spnte9 = 

274 { 

275 NULL, 

276 NULL, 

277 NULL, 

278 NULL, 

279 0, 

280 0, 

281 VSPRITE, 

282 200, 

283 300, 

284 14, 

285 14, 

286 0, 

287 0, 

288 0, 

289 ÄDataCOD, 

290 NULL, 

291 NULL, 

292 &spritecolors9L0D, 

293 NULL, 

294 0, 

295 0 

296 ); 

297 

298 struct VSpnte spritelO = 

299 C 

300 NULL, 

301 NULL, 

302 NULL, 

303 NULL, 

304 0, 

305 0, 

306 VSPR1TL, 

307 230, 

308 10, 

309 14, 

310 14, 

311 0, 

312 0, 

313 0, 

314 ÄDataCO], 

315 NULL, 

316 NULL, 

317 &spn tecolorslOCO], 

318 NULL, 

319 0, 

320 0 
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321 >; 

322 

323 struct VSprite spriteil = 

324 { 

325 NULL, 

326 NULL, 

327 NULL, 

328 NULL, 

329 0, 

330 0, 

331 VSPRITE, 

332 50, 

333 160, 

334 14, 

335 14, 

336 0, 

337 0, 

338 0, 

339 ÄDataCOJ, 

340 NULL, 

341 NULL, 

342 &spritecolorsl1COJ, 

343 NULL, 

344 0, 

345 0 

346 >; 

347 

348 struct VSprite sprite12 = 

349 < 

350 NULL, 

351 NULL, 

352 NULL, 

353 NULL, 

354 0, 

355 0, 

356 VSPRITE, 

357 150, 

358 240, 

359 14, 

360 14, 

361 0, 

362 0, 

363 0, 

364 &Datat03, 

365 NULL, 

366 NULL, 

367 &spritecolorsl2C0J, 

368 NULL, 

369 0, 

370 0 

371 >; 

372 

373 struct NewScreen ns = 

374 l 

375 0, 

376 0, 

377 320, 

378 256, 

379 2, 

300 0, 

381 1, 

38? MJLL, 

383 CUSTOMSCREEN, 

384 NIJI I , 


/* Hrreen-Struktur */ 
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385 NULL, 

386 NULL, 

387 NULL 

388 >; 

389 

390 

391 main() 

392 ( 

393 LÜNG warte; /* Variable tuer Warte-Schlei-fe */ 

394 struct Gelsln-fo gels; /* Leere GelsIn-fo-Structure */ 

395 

396 if ((IntuitionBase = (struct Intui tionBase *) /* l.ibs oe-f+nen */ 

397 üpenl.i brary( "intui tion. 1 ibrary" , 0) > == 0) exitO; 

398 

399 i-f ((G+xBase = (struct G-fxBase *) 

400 OpenLibrary("graphics.1ibrary", 0)) == 0) exit(); 

401 

402 /* Screen oe-f-fnen */ 

403 l -f ((screen = (struct Screen*) üpenSc reen (&ns)) == NULL) exit(); 

404 

405 /* RastPort zuweisen */ 

406 rp = &screen->RastPort; 

407 

408 gels.sprRsrvd = -1; /* Gelsln-fo deklarieren */ 

409 gels.nextLine = (WORD *)A1locMem(sizeof(UÄTRD) * 8 

410 , ME/*F_CLF.PR! f^Er^F PUBl. IO; 

411 gels.lastColor = (WORD * *)A11ocMem(sizeof(LÜNG) * 8 

412 ,MLMF CLEARIMEMF PUBL IC); 

413 gels.col lHandler = (struct collTable *)Al 1 ocMem(sizeo-f(struct 

414 col1Table)CLEARIMEMF PUBLIC); 

415 gels.leftmost = 0; 

416 gels.rightmost = rp->BitMap->BytesPerRow *8-1; 

417 gels.topmost = 0; 

418 gels.bottommost = rp->BitMap->Rows - 1; 

419 

420 rp->GelsIn-fo = &qels; 

421 

422 /* Gels initialisieren */ 

423 InitGels(&VSl,&VS2,&gels); 

424 


425 

AddVSprite(&spritel,rp); 

/* 

Sprites setzen 

*/ 


426 

AddVSprite(&spnte2,rp> ; 

/* 

12 Spr i tes: 

*/ 


427 

AddVSpr i te(&sprite3,rp); 

/* 

Unterschied zu 

*/ 


428 

AddVSprite(&spr i te4,rp); 

/* 

SimpleSprites 

*/ 


429 

AddVSpr 1 te(&sprite5,rp); 

/* 

wird somit 

*/ 


430 

AddVSprlte(&spr i te6,rp); 

/* 

deutlich, auch 

*/ 


431 

AddVSprite(&sprite7,rp); 

/* 

die Farbprioritaet 

*/ 

432 

AddVSprlte(&spr i te8,rp); 

/* 

der Hardwaresprite 

*/ 

433 

AddVSprite(&sprite9,rp); 

/* 

deutlich */ 



434 

AddVSprite(&spritel0,rp); 





435 

AddVSpr i te(&spritel1,rp); 





436 

AddVSprlte(&spritel2,rp); 





437 






438 

for(warte = 0; warte < 230; warte 

++> 




439 

{ 





440 

sprite3.X = warte; 

/* 

ein Sprite bewegen 

*/ 

441 

spnte3.Y = warte; 





442 






443 

SortGList(rp); 

/* 

VSprites neu sortieren */ 

444 

DrawGList(rp,&screen->ViewPort); 





445 






446 

MrgCop(ViewAddress()); 

/* 

in Copper-Liste eintragen */ 

447 

LoadView(ViewAddress()); 

/* 

und darstellen. 

*/ 


448 

>; 
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449 

450 for(warte = 0; warte < 500000; ++warte); 

451 

452 RemVSpr i te(&spritel); /# Sprites Ineschen #/ 

453 RemVSpr i te ( &spr i te2 ); 

454 RemVSpr i te(&sprlte3); 

455 RemVSprite(&sprlte4); 

456 RemVSpr i te(&spr i te5); 

457 RemVSpr i te(&sprlte6); 

458 RemVSprlte(&spr i te 7 ); 

459 RemVSpr i te(&sprite8); 

460 RemVSpr i te(&spr i te9); 

461 RemVSprite(&spritelO); 

462 RemVSpr i te(&spntel 1 ); 

463 RemVSprite(&sprjtel2); 

464 

465 CloseScreen(screen); /* Libs und Screen schliessen %/ 

466 CloseLibrary (G-f xBase); 

46/ CloseLibrary(IntuitionBase); 

468 > 
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5.3 Animation durch SetPointer 

Intuition stellt dem Programmierer den Befehl SetPointer zur Verfügung, 
mit dessen Hilfe er einen windowspezifischen Mauszeiger verwenden kann. 
Dieser Zeiger ist immer dann sichtbar, wenn das betreffende Window akti¬ 
viert ist. 

Für eigene Programme kann man sich also vorstellen, daß ein eigener Screen 
geöffnet wird, der von einem Borderless-Window ohne Gadgets abgedeckt 
wird. Das bedeutet, daß der entsprechende Screen nicht mehr mit der Maus 
»heruntergezogen« werden kann, was für einige Anwendungen sicherlich 
nicht wünschenswert wäre. Zudem ist die Screen-Titelzeile verdeckt, so daß 
ein völlig freier Bildschirm zu sehen ist. Nun kann der Programmierer einen 
eigenen Mauszeiger setzen, den er laufend durch einen neuen ersetzt. Somit 
kann mit sehr einfachen Mitteln Animation erzielt werden, ohne sich mit 
Hardware-Sprites, VSprite-Structures oder Ähnlichem herumschlagen zu 
müssen. 

Der Befehl hat folgende Syntax: 

SetPointer(WindowPtr,Data,Höhe,Breite,X,Y); 

»WindowPtr« ist ein Zeiger auf die Window-Structure des Windows, für das 
der Zeiger erstellt werden soll. »Höhe« und »Breite« geben Höhe und Breite 
des Mauszeigers in Pixel an, wobei diese in niedriger Auflösung, also 320 x 
256 Pixel, angegeben werden müssen. Für die Breite des Zeigers gilt, wie für 
alle Hardware-Sprites, die Einschränkung auf 16 Pixel. X und Y geben die 
Position des sogenannten »Hot-Spot« an. Das ist der Punkt, der über einem 
Gadget oder einem Menüpunkt stehen muß, damit Intuition dies als ange¬ 
wählt erkennt. Seltsamerweise muß dieser Punkt in negativen Koordinaten, 
relativ zur linken, oberen Ecke des Zeigers angegeben werden. Das heißt, 
wenn der Zeiger die Form eines Kreuzes hat und 16 Punkte hoch wie breit 
ist, und den »Hot-Spot« in der Mitte haben soll, muß für X und Y jeweils -7 
angegeben werden. 

Data ist ein Zeiger auf die Daten für den neuen Mauszeiger. Wie schon im 
Kapitel über die einfachen Hardware-Sprites gesagt, muß auch bei dieser 
Anwendung darauf geachtet werden, daß die Daten innerhalb der unteren 
512 KByte RAM liegen. Im Demonstrationsprogramm haben wir darauf ver¬ 
zichtet, da sich gezeigt hat, daß das Programm meistens auch mit mehr Spei¬ 
cherplatz einwandfrei lief. Sollte es dennoch Probleme geben, so verfahren 
Sie bitte nach dem gleichen Schema, wie bei den Hardware-Sprites. 

Folgendermaßen müssen diese Daten bereitgestellt werden: 
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Nehmen wir an, daß für ein Window, mit dem Zeiger "WindowPtr" auf die 
zugehörige WindowStructure folgendes Kreuz als Mauszeiger gesetzt werden 
soll: 



$1 bedeutet Farbe 1 
1 bedeutet Farbe 2 
| bedeutet Farbe 7 


Farbe 0, also durchsichtig, ist freigelassen. 

Für Farbe 0 muß die erste und die zweite Bitplane frei sein. 

Für Farbe 1 muß Bitplane 1 gesetzt und Plane 2 nicht gesetzt sein. 
Für Farbe 2 muß Bitplane 2 gesetzt und Plane 1 nicht gesetzt sein. 
Für Farbe 3 müssen beide Planes gesetzt sein. 


Daraus folgt also: 


Zelle 

1 

Plane 

1 

1000000000000011 


0x8007 



Plane 

2 

1100000000000001 


0XC001 

Zelle 

2 

Plane 

1 

0100000000000110 


0x4006 



Plane 

2 

0110000000000010 


0x6002 

Zelle 

7 

Plane 

1 

0010000000001100 


0x200C 



Plane 

2 

0011000000000100 


0x7004 

Zelle 

4 

Plane 

1 

0001000000011000 


0x1018 



Plane 

2 

0001100000001000 


0x1808 

Zelle 

5 

Plane 

1 

0000100000110000 


0x0870 



Plane 

2 

0000110000010000 


0X0C10 

Zelle 

6 

Plane 

1 

0000010001100000 


0x0460 



Plane 

2 

0000011000100000 


0x0620 

Zelle 

7 

Plane 

1 

0000001011000000 


0X02C0 



Plane 

2 

0000001101000000 


0x0740 

Zelle 

8 

Plane 

1 

0000000110000000 


0x0180 



Plane 

2 

0000000110000000 


0x0180 

Zelle 

9 

Plane 

1 

0000001110000000 


0x0780 



Plane 

2 

0000000111000000 


0X01C0 

Zelle 

10 

Plane 

1 

0000011001000000 


0x0640 



Plane 

2 

0000001001100000 


0x0260 

Zelle 

11 

Plane 

1 

0000110000100000 


0X0C20 



Plane 

2 

0000010000110000 


0x0470 
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Zeile 

12 

Plane 

1 

0001100000010000 


0x1810 



Plane 

2 

0000100000011000 


0x0818 

Zelle 

13 

Plane 

1 

0011000000001000 


0x3008 



Plane 

2 

0001000000001100 

* 

0x1000 

Zelle 

14 

Plane 

1 

0110000000000100 


0x6004 



Plane 

2 

0010000000000110 


0x4006 

Zeile 

15 

Plane 

1 

1100000000000010 


0x0002 



Plane 

2 

0100000000000011 


0x4003 

Zelle 

16 

Plane 

1 

1000000000000001 


0x8001 



Plane 

2 

1000000000000001 


0x8001 


Im Programm sieht das dann folgendermaßen aus: 


USHORT datat] - 

{ 

0x0000, 0x0000, /*Start-BytesmUsseninmer0 sein»/ 

0x8005, 0xC001, /» Sprite-Daten von oben */ 

0x4006, 0x6002, 

0x2000, 0x3004, 

0x1018, 0x1808, 

0x0830, 0X0C10, 

0x0460, 0x0620, 

0X02C0, 0x0340, 

0x0180, 0x0180, 

0x0380, 0x01C0, 

0x0640, 0x0260, 

0x0020, 0x0430, 

0x1810, 0x0818, 

0x3008, 0x1000, 

0x6004, 0x4006, 

0x0002, 0x4003, 

0x8001, 0x8001, 

0x0000, 0x0000 /* End-Bytes nüssen inner 0 sein*/ 

); 


nain() 

{ 


SetPointer(UlndovPtr,&data[0],16,16,-7,-7); 


) 

Soll wieder der normale Intuition-Mauszeiger erscheinen, so kann dies mit 
ClearPointer(WindowPtr) erreicht werden. 

Für dieses Thema siehe auch Kapitel 3.5.11 und 3.5.3. 

Weitere Informationen können Sie aus dem folgenden Programm ableiten: 
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1 /******************************* 

3 Pcnnter - Demonstration 

4 last upxjate 26/06/07 

5 von trank Kremser und Joerq koch 

6. (c) Markt & lechnik 190/ 

7 

B ******************************** 

9 


10 

Pointer-Demonstration zeigt 

wie einfach die Veraenderunq des 

11 

von statten geht. 



12 




13 

*****»************************/ 

14 

15 

«inclüde <exec/types.h> 


/* Include / Files */ 

16 

«include <exec/nodes.h> 



17 

«include <exec/1 ists.h> 



18 

Mine lüde *;exec/ports.h> 



19 

#inclüde <exec/memory.h> 



20 

«include <exec/devices.h> 



21 

«mclüde <devices/keymap.h> 



22 

«include <qraphics/regions. 

h> 


23 

Winclude <graphics/copppr.b> 


24 

«include <graphics/qels.h> 



25 

«inc 1 ude <qraphics/qf xbase. 

h> 


26 

Mine lüde <qraphics/qfx.h> 



27 

«inclüde <qraphics/clip.h> 



28 

«include <graphics/view.h> 



29 

«mclude <qraphics/rastport 

.h> 

30 

«include <qraphics/layers.h> 


31 

«include <intuition/Intuition. 

h> 

32 

«include <hardware/blit.h> 



33 




34 

struct IntuitionBase »IntuitionBase; /* Lib - Zeiger */ 

35 

struct GfxBase »GfxBase; 



36 




37 

struct RastPort *rp; 



38 

struct Window *window; 



39 




40 

struct NewWindow nw = 

/* 

New Window - Struct.ure */ 

41 

( 



42 

0, 

/* 

linke Ecke */ 

43 

0, 

/* 

obere Ecke */ 

44 

640, 

/* 

Breite */ 

45 

256, 

/* 

Hoehe */ 

46 

3, 

/* 

DetailPen */ 

47 

1, 

/* 

BlockPen */ 

48 

NULL, 

/* 

1DCMP / Flags */ 

49 

OCTlvmt : M K'ORFRFt HESH, 

/* 

Flaqs */ 

50 

NULL, 

/* 

Erstes Gadqet */ 

51 

NULL, 

/* 

LheckMark */ 

52 

"Rnimation durch SetPointer", /* Window Titel */ 

5 % 

Mil, 

/* 

Pointer auf den screen */ 

54 

MJLL, 

/* 

Pointer auf superbitmap */ 

55 

0, 

/* 

min Breite */ 

56 

0 , 

/* 

min Hoehe */ 

57 

0, 

/* 

max Breite */ 


0 , 

/* 

max Hoehe */ 

59 

WBENOTSCRLt N 

/* 

Typ */ 

60 

>; 



61 




62 

USHÜRT imaqellJ = /* 

Pointer Image * 

63 

( 



64 

0,0. 
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65 



66 

0x0300, 0x0000, 


67 

OxOC30, 0x0000, 


68 

0x1008, 0x0000, 


69 

0x23C4, 0x03U0, 


70 

0x4422, 0x0420, 


71 

0x4812, 0x0810, 


72 

0x9009, 0x1008, 


73 

0x9009, 0x1008, 


74 

0x9009, 0x1008, 


75 

0x9009, 0x1008, 


76 

0x4812, 0x0810, 


77 

0x4422, 0x0420, 


7B 

0x23C4, 0x03C0, 


79 

0x1008, 0x0000, 


80 

0x0C3O, 0x0000, 


81 

0x03C0, 0x0000, 


82 



83 

0,0 


84 

>; 


85 



86 

USHORT Imaqe2C J = 

/# PointerImaqe */ 

87 

{ 


88 

0,0, 


89 



90 

0x03C0, 0x0000, 


91 

0x0C30, 0x0000, 


92 

0x1008, 0x0000, 


93 

0x2004, 0x0000, 


94 

0x4182, 0x0180, 


95 

0x4242, 0x0240, 


96 

0x8421, 0x0420, 


97 

0x8811, 0x0810, 


98 

0x8811, 0x0810, 


99 

0x8421, 0x0420, 


100 

0x4242, 0x0240, 


101 

0x4182, 0x0180, 


102 

0x2004, 0x0000, 


103 

0x1008, 0x0000, 


104 

0x0C3O, 0x0000, 


105 

0x03C0, 0x0000, 


106 



107 

0,0 


108 

>; 


109 



1 10 

USHORT Imaqe3[ 3 = 

/* PointerImaqp #/ 

111 

{ 


112 

0,0, 


113 



114 

0x03C0, 0x0000, 


115 

0x0C30, 0x0000, 


116 

0x1008, 0x0000, 


117 

0x2004, 0x0000, 


1 18 

0x4002, 0x0000, 


119 

0x4002, 0x0000, 


120 

0x8181, 0x0180, 


121 

0x8241, 0x0240, 


122 

0x8241, 0x0240, 


123 

0x8181, 0x0180, 


124 

0x4002, 0x0000, 


125 

0x4002, 0x0000, 


126 

0x2004, 0x0000, 


127 

0x1008, 0x0000, 


128 

0x0C30, 0x0000, 
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129 0x03C0, 0x0000, 

130 

131 0,0 

132 >; 

133 

134 main() 

135 { 

136 LONG schleife; 

137 LONG warte; /% oeffnen der Libs %/ 

138 

139 if('(GfxBase = (struct GfxBase *)OpenL 1 brary( "qraphics. 1 ibrary" ,0))) 

140 ( 

141 close thingsO; 

142 exit(); 

143 >; 

144 

145 if('.< IntuitionBase = (struct IntuitionBase *) 

146 OpenLibrary( "intuition. 1 ibrary" ,0))) 

147 { 

148 close thingsO; 

149 exitO; 

150 >; /* oeffnen des Window %/ 

151 

152 if ('.(window = (struct Window *)OpenWindow(&nw) )) 

153 l 

154 close thingsO; 

155 exit(); 

156 >; 

157 

150 /* abwechselndes Setzen der Pointer #/ 

159 fortschleife = 0; schleife < 50; schleife-»-*-) 

160 { 

161 SetPointer(window,&ImaqelC03,16,16,-7,7); 

162 for(warte = 0; warte < 10000; warte-»--*-); 

163 SetPointer(window,&Image2C0D,16,16,-7,7); 

164 fortwarte = 0; warte < 10000; warte++); 

165 SetPointer(window,&lmage3L0J,16,16,-7,7); 

166 for(warte = 0; warte < 10000; warte++); 

167 SetPointer(window,&Image2E03,16,16,-7,7); 

168 fort warte = 0; warte < 10000; warte++); 

169 >; 

170 close thingst ); /* Unterroutine zum Schliessen */ 

171 > 

172 

173 close things() 

174 < 

175 CIoseWindow(window); 

176 Closel .ibrary (GfxBase); 

177 CloseLibrary(IntuitionBase); 

178 > 


/* schliessen des Window */ 
/# und Libs */ 
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5.4 Animation durch Preferences 

Die Befehle funktionieren sowohl mit der alten Workbench-Version 1.1 als 
auch mit der Version 1.2. 

Auch mit Preferences können Effekte erzielt werden. Ein solcher Effekt ist 
zum Beispiel das Verschieben des Bildschirmausschnittes. Aber auch die 
anderen Voreinstellungen, die mit dem Programm Preferences eingestellt 
werden können, sind veränderbar, wie zu sehen sein wird. 

Um auf die Preferences-Daten zugreifen zu können, sind zwei Befehle vor¬ 
handen: 

- GetDelPrefs 

- GetPrefs 

Der Unterschied zwischen den beiden Befehlen wird später erläutert. Als 
Parameter verlangen beide Befehle einen Zeiger auf einen Speicherbereich, 
in den die Preference-Daten kopiert werden sollen und die Byteanzahl, die 
kopiert werden soll. Dies ist zwar umständlicher als wenn direkt eine 
Preference-Structure angegeben werden würde, hat aber den Vorteil, daß ein 
Programm, das auf diese Weise zu den erwünschten Daten gelangt, auch auf 
die Nachfolgeversionen des Amiga übertragbar ist. 

Üblicherweise verwendet man den Befehl in folgender Weise: 


struct Preferences pref; 


main() 
{ 


GetPrefs(&pref.sizeof(struct Preferences)); 


) 

Im Anschluß an den Befehl GetPrefs oder GetDelPrefs können die Daten 
beliebig manipuliert werden. Wie, ist aus dem Demonstrationsprogramm 
ersichtlich. 

Um die Daten dann auch verwenden zu können, müssen sie mit SetPrefs 
entweder auf Diskette gesichert werden, von wo sie nach jedem Bootvorgang 
geladen werden oder in den Speicher zurückkopiert werden, wobei sie sofort 
vom System verwendet werden. 
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Welche Daten modifiziert werden können, ist aus der Preference-Structure 
ersichtlich: 

struct Preferences 

{ 

BYTE FontHeight; 

UBYTE PrinterPort; 

USHORT BaudRate; 

struct tlmeval KeyRptSpeed, KeyRptDelay; 
struct tlmeval Doubleclick; 

USHORT PoInterdatrixt POINTERS IZE]; 

BYTE XOffset, YOffset; 

USHORT color17, color18, color19; 

USHORT PointerTlcks; 

USHORT colorB, colorl, color2, colorj; 

BYTE ViewXOffset, VievYOffset; 

WORD VievInltX, VlewInltY; 

BOOL EnableCLI; 

USHORT PrlnterType; 

UBYTE PrinterFllenametFILENAME_SIZE]; 

USHORT PrintPitch; 

USHORT PrintQuallty; 

USHORT PrintSpaclng; 

UWORD PrintLeftMargin, PrintRightMargln; 

USHORT Printimage; 

USHORT PrlntAspect; 

USHORT PrlntShade; 

WORD PrlntThreshold; 

USHORT PaperSlze; 

UUORD PaperLength; 

USHORT PaperType; 

UBYTE SerRWBlts; 

UBYTE SerStopBut; 

UBYTE SerParShk; 

UBYTE LaceUB; 

UBYTE WorkNametFILE]; 

BYTE RowSlzeChange; 

BYTE ColumnSizeChange; 

BYTE Paddingt141; 


5.4.1 GetDefPrefs 

Syntax: GetDefPrefs(PrefBuffer,Bytes); 

Funktion: Holt die Preference-Einstellungen, die beim Booten einge¬ 

stellt waren von Diskette. 

Parameter: PrefBuffer -> Zeiger auf den Speicherbereich, in den 

die Preference-Daten kopiert werden 
sollen. 

Bytes -> Anzahl der Bytes, die kopiert werden 

sollen. 
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Ergebnis: Kein Ergebnis. 

Datentyp: ULONG PrefBuffer; 

int Bytes; 

Sonstiges: Wie die Parameter am besten gewählt werden, ist unter 

Kapitel 5.3 »Animation mit Preferences« beschrieben. 

Referenz: Siehe auch GetPrefs 

5.4.2 GetPrefs 

Syntax: GetPrefs(PrefBuffer,Bytes); 

Funktion: Holt die Preference-Einstellungen, die momentan eingestellt 

sind, aus dem Speicher. 

Parameter: PrefBuffer -> Zeiger auf den Speicherbereich, in den 

die Preference-Daten kopiert werden 
sollen 

Bytes -> Anzahl der Bytes, die kopiert werden 

sollen 

Ergebnis: Kein Ergebnis. 

Datentyp: ULONG PrefBuffer; 

int Bytes; 

Sonstiges: Wie die Parameter am besten gewählt werden, ist unter 

Kapitel 5.3 »Animation mit Preferences« beschrieben. 

Referenz: Siehe auch GetDefPrefs 

5.4.3 SetPrefs 

Syntax: SetPrefs(PrefBuffer,Bytes,Disk); 

Funktion: Speichert die Preference-Einstellungen entweder auf Diskette 

oder in den dafür vorgesehenen Speicherbereich. 

Parameter: PrefBuffer -> Zeiger auf den Speicherbereich, der 

die Preference-Daten enthält, die ge¬ 
sichert werden sollen. 


Bytes 


-> Anzahl der Bytes, die gesichert werden 
sollen. 
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Disk -> ist eine Boolesche Variable und setzt 

fest, ob die veränderten Preference- 
Daten dauerhaft oder nur vorüberge¬ 
hend gespeichert werden sollen. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

ULONG PrefBuffer; 
int Bytes; 
bool Disk; 

Sonstiges: 

Wie PrefBuffer und Bytes am besten gewählt werden, ist 
unter Kapitel 5.4 »Animation mit Preference« beschrieben. 


Dieser Befehl sollte nur in Ausnahmesituationen verwendet 
werden, da er unter Umständen fatale Folgen haben kann. 

Referenz: 

Siehe auch GetDefPrefs und GetPrefsl 
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1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 
43 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 


/>M************************* 


Pr e-f erences-Demons t r a t ion 
last update 26/05/87 
Frank Kremser und Joerg Koch 
(c) Markt & Technik 1987 


*##*###*#w***************** 

Zeigt die Leistungsfaehigkeit von Preferences ! ! ! 1 

Durch verschieben der Offsets kann Prefs auch zur Animation verwendet 
werden. 


***************************/ 


ttinclude 
#inclüde 
#include 
#include 
ttinclude 
ttinclude 
ttinclude 
ttinclude 
ttinclude 
ttinclude 
ttinclude 
ttinclude 
ttinclude 
ttinclüde 
ttinclude 
ttinclüde 
ttinclude 


<exec/types.h> 

<exec/nodes.h> 
<exec/lists.h> 

<exec/ports.h> 
<exec/devices.h> 
<devices/keymap.h> 
<graphics/regions.h> 
<graphics/copper. h> 
<graphics/gels.h> 
<graphics/gfxbase.h> 
<graphics/gfx.h> 
<graphics/c1ip.h> 
<graphics/view.h> 
<graphics/rastport.h> 
<graphics/1ayers.h> 
<intuition/intuition.h> 
<hardware/blit.h> 


/* Include-Files */ 


struct IntuitionBase *IntuitionBase; /* Lib-Zeiger */ 
struct GfxBase *GfxBase; 


main() 

< 

struct Preferences pref; /* Preferences-Structure bereitstellen */ 

LONG schleife; /* Variablen fuer Animation */ 

LONG x,y; 

/* Geffnen der Libs */ 
if ('. (GfxBase = (struct GfxBase *) 

OpenLibrary("graphics.library",0))) exit(); 

if('.(IntuitionBase = (struct IntuitionBase #) 

OpenLibrary("intuition.1lbrary",0))> exit<); 

GetPrefs(&pref»sizeof(struct Preferences)); /* holen von Preferences */ 

x = pref.ViewXOffset; 

y = pref.ViewYOffset; /* Offset retten */ 

pref.ViewYOffset = 0; 

SetPrefs(&pref,sizeof(struct Preferences),FALSE>; /# neue %/ 

/% Prefs setzen */ 

for(schleife = 0; schleife < 255; schleife++) /* Offset laufend */ 

/* veraendern %/ 
i 

pref.ViewXOffset = schleife; 

SetPrefs(&pref,sizeof(struct Preferences)»FALSE); /* Prefs setzen */ 

>; 

for(schleife = 0; schleife < 255; schleife++) 
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65 { 

66 pref.ViewYOffset = schleife; 

67 SetPrefs(&pref ,sizeof (struct Preferences) ,FALSE>; /* Prefs setzen */ 

68 >; 

69 

70 for(schleife = 255; schlei-fe > 0; schlei-fe—) 

71 { 

72 pre-f.ViewXOffset = schlei-fe; 

73 SetPrefs(&pref,sizeof(struct Pre-ferences) ,FALSE>; /* Prefs setzen */ 

74 >; 

75 

76 -for(schlei-fe = 255; schleife > 0; schleife—) 

77 < 

78 pref.ViewYOffset = schleife; 

79 SetPrefs(&pref»sizeof(struct Preferences),FALSE); /% Prefs setzen */ 

80 ); 

81 

82 pref.ViewXOffset = x; /# alten Offset setzen */ 

83 pref.ViewYOffset = y; 

84 SetPrefs(&pref,sizeof(struc t Preferences),FALSE); 

35 

86 CloseLibrary(GfxBase); /* Libs schliessen #/ 

87 CloseLibrary<IntuitionBase); 

88 > 
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Die Programmbedienung 


Die neue > Rechnergeneration, die derzeit auch durch die Amiga-Serie 
repräsentiert wird, stellt nicht nur mehr (Rechen-) Leistung zur Verfügung, 
sondern besitzt auch neue Betriebssysteme, die sich besonders durch ihre 
grafische Benutzeroberfläche, beim Amiga »Intuition« genannt, hervorheben. 
Diese Benutzeroberflächen erleichtern dem ungeübten Benutzer das 
Arbeiten auf dem Computer ungemein. 

Für professionelle Programme auf solchen Rechnern ist die Verwendung 
dieses Hilfsmittels praktisch schon ein Muß, auch wenn es ab und an kriti¬ 
siert wird. 

Die Vorteile dieses Systems liegen auf der Hand: 

- Einfache Handhabung 

- Schnelle Einarbeitung 

- Kurze Lernphase 

und damit hohe Bedienerfreundlichkeit. 

Natürlich hat dieses System bei einigen Anwendungen auch Nachteile, doch 
können diese ausgemerzt werden, indem in diesen Fällen die konventionellen 
Methoden verwendet werden, die das Amiga-System in Form von CLI zur 
Verfügung stellt. 
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6.1 Programmbedienung mit dem Amiga 

In diesem Kapitel wollen wir uns mit der Bedienung eines Programms durch 
den Benutzer beschäftigen. Dem Programmierer stehen dabei verschiedene 
Mittel zur Verfügung, mit deren Hilfe er die Bedienung für den Benutzer so 
komfortabel wie möglich gestalten kann: 

- Menüs Menüs kann der Benutzer erreichen, indem er die 

Menütaste - die rechte Maustaste - betätigt, auf 
einen Menüoberbegriff geht, wodurch die verschie¬ 
denen Menüunterpunkte sichtbar werden, und sich 
dann einen dieser Punkte auswählt. Dabei kann 
noch ein weiteres Untermenü sichtbar werden. 

Menüpunkte können entweder Aktionen sein, die 
das Programm ausführt, oder aber Schalter, die 
gesetzt werden können. Ist ein Menüschalter 
gesetzt, wird ein »Checkmark« (siehe auch Kapitel 
3 »Das Window« - Window-Structure) daneben 
gezeichnet. 

- Gadgets Intuition stellt eine Vielzahl von Gadget-Typen zur 

Verfügung, die vom Programmierer verwendet 
werden können. Im einzelnen sind sie in Kapitel 8 
erläutert. 

Sie können als Schalter, die betätigt werden müs¬ 
sen, oder aber zur Eingabe dienen. Auch können 
Schiebepotentiometer mit Hilfe von Proportional- 
gadgets realisiert werden. Solche werden zum Bei¬ 
spiel zur Einstellung von Farben verwendet. 

Die zuvor genannten Möglichkeiten werden zur Eingabe verwendet. 

Aber auch zur Ausgabe stehen Mittel zur Verfügung: 

- Alerts Alerts sollten nur dann verwendet werden, wenn 

dem Benutzer wirklich wichtige Meldungen zu 
übermitteln sind, da sie eine »Schock«-Behandlung 
darstellen. Es können zwei Alert-Typen verwendet 
werden. Einmal die System-Alerts, die schon 
»vorgefertigt« sind, also nicht verändert werden 
können. Die zweite Möglichkeit ist die Verwen¬ 
dung von eigenen Alerts. Bei diesen kann der Pro¬ 
grammierer einen eigenen Text angeben. 
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- Requester 


Requester können ausgegeben werden, um den 
Programmbenutzer zu einer bestimmten Handlung 
zu bewegen, ein Beispiel dafür ist der »No Disk 
Present«-Requester, oder um bestimmte Eingaben 
abzufragen, wie der »Load File«-Requester bei 
Graphicraft. 
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Die Menüs 


Intuition stellt dem Programmierer sogenannte Menüs zur Verfügung. Dies 
sind Kästen, die erscheinen, wenn der rechte Mausknopf betätigt wird und 
der Mauszeiger über einem Menüpunkt steht. Anschließend kann einer der 
Punkte, die in dem Kasten aufgeführt sind, angewählt werden. Die Punkte 
können entweder als Grafik oder als Text dargestellt werden. Zudem kann 
ein Menüpunkt entweder eine Handlung starten oder aber einen Zustand 
setzen, also ein Attribut. 
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7.1 Der Aufbau der Menüs 


Ist die rechte Maustaste gedrückt, so erscheint am oberen Screen-Rand die 
Menüzeile. Diese Menüzeile enthält verschiedene Menüoberbegriffe. Steht 
die Maus auf einem Menüoberbegriff, so erscheint der zugehörige Menü¬ 
kasten. Dieser Kasten enthält die verschiedenen Einträge, Items genannt. Bei 
verschiedenen Items erscheint ein weiterer Kasten, Subitem genannt. 

Jedes dieser Items, bzw. Subitems kann bei Betätigung entweder ein Attribut 
setzen oder aber eine Handlung starten. Das CleanUp-Item auf der Work- 
bench startet zum Beispiel eine Handlung. Dahingegen sind die Farbitems 
bei der Farbauswahl in Graphicraft Items, die Attribute setzen, nämlich die 
Farbe. Normalerweise werden an Menüpunkte, die Attribute setzen, eine 
»Checkmark« - ein Häkchen - gezeichnet. Soll ein anderes Zeichen 
erscheinen, so kann dieses Zeichen in der zugehörigen Window-Structure 
gesetzt werden (siehe dort). 

Wir wollen nun ein Menü aufbauen. Dieses Menü soll nur einen Eintrag 
- ein Item - haben. Dazu müssen wir als erstes den Text setzen, den dieses 
Item haben soll. Dies geschieht über IntuiText: 

struct IntuiText itemtext * 

{ 

2 , 

0 . 

JAM1, 

5, 

J, 

NULL, 

"Test-Item”, 

NULL 

); 


Anschließend muß das Item selbst erstellt werden. Dazu benötigen wir eine 
Menultem-Structure. Diese hat folgende Form: 


struct Menuitem 
{ 

struct Menuitem »Nextltem; 
USHORT LeftEdge, TopEdge; 
USHORT Width, Height; 
USHORT Flags; 

LONG MutualExclude; 

APTR ItemFill; 

APTR SelectFl11; 

BYTE Command; 

struct Menuitem »Subitem; 

USHORT NextSelect; 

) 


Zeiger auf nächstes Item Im Menü 
linke, obere Ecke des Items 
Breite und Höhe des Items 
Item-SpeziflkatIonen 
Exclusiv-Bedingung 
Zeiger auf Image oder IntuiText 
Zeiger auf alternativ Image o. Text 
Command-Zeichen 

Zeiger auf zugehöriges Subitem 
benötigt Intuition 


MutualExclude, Command und Subitem werden später erklärt. 
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Für Flags stehen folgende Möglichkeiten zur Verfügung: 

CHECKIT Ist dieses Flag gesetzt, setzt das zugehörige Item 

ein Attribut. 


CHECKED 


ITEMTEXT 

COMMSEQ 

ITEMENABLED 

HIGHCOMP 

HIGHBOX 


Ist dieses Flag gesetzt, bedeutet dies, daß das 
Attribut zu Beginn gesetzt ist. Es wird also gleich 
zu Anfang ein Häkchen gezeichnet. 

Das Item ist ein Text-Item. 

Zu diesem Item gibt es eine Tasten-Sequenz, die 
die gleiche Funktion hat. Zudem wird die Tasten¬ 
sequenz mit in das Menü gezeichnet. 

Dieses Flag beschreibt, ob das Item eingeschaltet 
ist, das heißt, ob es abgefragt wird. Ist es nicht ein¬ 
geschaltet, wird es gepunktet dargestellt. 

Das Item wird komplementiert dargestellt, wenn 
der Mauszeiger über ihm steht. 

Das Item wird umrahmt, wenn der Mauszeiger 
über ihm steht. 


HIGHIMAGE 


HIGHNONE 

ISDRAW 

HIGHITEM 


Das Item wird nicht durch das normale Image, 
bzw. den Text, sondern durch das Image, bzw. den 
Text dargestellt, auf das, bzw. den durch SelectFill 
gezeigt wird, wenn der Mauszeiger über ihm steht. 

Das Item wird nicht verändert, wenn der Maus¬ 
zeiger über ihm steht. 

Dieses Flag wird von Intuition gesetzt, wenn das 
Item zur Zeit zu sehen ist. 

Dieses Flag wird von Intuition gesetzt, wenn der 
Mauszeiger über diesem Item steht. 


Unser Item hat also folgende Form: 


struct Menuitem Item = 

{ 

NULL, /* Kein weiteres Item im Menü */ 

2 , 

2 , 

98, 

12 , 

ITEMTEXT!ITEMENABLED!HIGHBOX, 

0 . 

(APTR) Sltemtext, /* Zeiger auf unser Image 
NULL, /* Keine Alternativ-Image 
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NULL, 

0 

}; 

Anschließend muß noch die Menü-Structure für den Menüoberpunkt erstellt 
werden, unter dem unser Item erscheinen soll. Diese hat folgende Form: 

struct Menu 
{ 

struct Menu*NextMenu; Zeigeraufdennächsten Menüpunkt 
SHORT LeftEdge, TopEdge; linke, obere Ecke 
SHORT Width, Height; Breite und Höhe des Menüoberpunkt 

USHORT Flags; 

BYTE *MenuName; Text des Menüoberpunktes 

struct Menultem «Firstitem; Zeiger auf erstes Item des Menüs 
); 

Für Flags gibt es folgende Möglichkeiten: 

MENUENABLED Das Menü ist eingeschaltet. Wenn es ausgeschaltet 
ist, wird es gepunktet dargestellt. 

MIDRAWN Intuition setzt dieses Flag, wenn der zugehörige 

Menükasten zu sehen ist 

Unsere Menu-Structure sieht also folgendermaßen aus: 

struct Menu menu * 

{ 

NULL, 

0 , 

0 , 

100 , 

10 , 

MENUENABLED, 

"Test-Menu”, 

&item 

); 


Nun können wir das Menü mit SetMenuStrip ((windowPtr,&menu); setzen. 
Immer wenn das Window, zu dem das Menü gehört, aktiviert ist, kann das 
Menü angewählt werden. 


7.1.1 ClearMenuStrip 

Syntax: ClearMenuStrip(windowPtr); 

Funktion: Löscht alle Menüs, die zu dem spezifizierten Window ge¬ 

hören. 

Parameter: windowPtr -> Zeiger auf die Window-Structure des 

Windows, dessen Menüs gelöscht wer¬ 
den sollen. 
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Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Window *windowPtr; 


Sonstiges: 

Mit SetMenuStrip können anschließend neue oder aber wie¬ 
der die gleichen Menüs gesetzt werden. 


Referenz: 

Siehe auch SetMenuStrip 

7.1.2 

ItemAddress 


Syntax: 

adr = ItemAddress(menunr,itemnr); 


Funktion: 

Ermittelt die Adresse der Menultem-Structure, die über die 
Menü-Nummer und Item-Nummer angegeben ist. 


Parameter: 

menunr -> Nummer des Menüs, in dem sich das 

Item befindet. 



itemnr -> Nummer des Items, nach dessen 

Menultem-Structure gesucht werden 
soll. 


Ergebnis: 

adr -> Adresse, an der sich die Menultem- 

Structure befindet. 


Datentyp: 

int menunr, itemnr; 

ULONG adr; 


Sonstiges: 

Bei der Abfrage der Menüs erhält man die Nummern der 
Menüs zurück, unter denen diese von Intuition gespeichert 
werden. Diese Nummern können durch diesen Befehl in eine 
Adresse gewandelt werden, mit der man leichter erfährt, wel¬ 
ches Item angewählt wurde. 



Das Ganze funktioniert allerdings nicht bei Subitems. 

7.1.3 

ITEMNUM 


Syntax: 

nr = ITEMNUM(code); 


Funktion: 

Ermittelt die Nummer des Items, das angewählt wurde. 


Parameter: 

code -> Code-Wert aus der Message-Structure 

der Message, die übergeben wurde. 


Ergebnis: 

nr -> Nummer des Items, das angewählt 

wurde. 
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Datentyp: SHORT code; 

int nr; 

Sonstiges: Die Items sind aufsteigend von 0 an numeriert. 

Referenz: Siehe auch Kapitel 7.3 »Die Abfrage von Menüs«, 

MENUNUM, SUBNUM 

7.1.4 MENUNUM 

Syntax: nr = MENUNUM(code); 

Funktion: Ermittelt die Nummer des Menüs, das angewählt wurde. 

Parameter: code -> Code-Wert aus der Message-Structure 

der Message, die übergeben wurde. 

Ergebnis: nr -> Nummer des Menüs, das angewählt 

wurde. 

Datentyp: SHORT code; 

int nr; 

Sonstiges: Die Menüs sind aufsteigend von 0 an numeriert. 

Referenz: Siehe auch Kapitel 7.3 »Die Abfrage von Menüs«, 

ITEMNUM, SUBNUM 

7.1.5 OffMenu 

Syntax: OffMenu(windowptr,nr); 

Funktion: Schaltet einen ganzen Menüoberpunkt ab. 

Parameter: windowptr -> Zeiger auf das Window, zu dem das 

Menü gehört. 

nr -> Nummer des Menüs, das abgeschaltet 

werden soll. 

Ergebnis: Kein Ergebnis. 

Datentyp: struct Window *windowptr; 

int nr; 

Sonstiges: Der Menüoberpunkt wird anschließend punktiert dargestellt. 


Referenz: 


Siehe auch OnMenu 
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7.1.6 


OnMenu 


Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 


OnMenu(windowptr,nr); 

Schaltet einen Menüoberpunkt ein. 

windowptr -> Zeiger auf das Window, zu dem das 
Menü gehört. 

nr -> Nummer des Menüs, das eingeschaltet 

werden soll. 

Kein Ergebnis. 

struct Window *windowptr; 
int nr; 

Der Menüoberpunkt wird nun nicht mehr punktiert darge¬ 
stellt 

Siehe auch OffMenu 


7.1.7 SetMenuStrip 


Syntax: 

SetMenuStrip(windowptr,menu); 


Funktion: 

Setzt die Menüs, die zu dem spezifizierten Window gehören. 

Parameter: 

windowptr -> Zeiger auf das Window, für das 

Menüs gesetzt werden sollen. 

die 


menu -> Zeiger auf die Menu-Structure 

ersten Menüs der Liste. 

des 

Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Window *windowptr; 
struct Menu *menu; 


Sonstiges: 

Um mehrere Menüoberpunkte zu bekommen, muß in der 
Menu-Structure des ersten Menüs ein Zeiger auf das zweite 
Menu und so weiter stehen. 

Referenz: 

Siehe auch ClearMenuStrip 
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7.1.8 


SUBNUM 


Syntax: 

nr = SUBNUM(code); 

Funktion: 

Ermittelt die Nummer des Subitems, das angewählt wurde. 

Parameter: 

code -> Code-Wert aus der Message-Structure 

der Message, die übergeben wurde. 

Ergebnis: 

nr -> Nummer des Subitems, das angewählt 

wurde. 

Datentyp: 

SHORT code; 
int nr; 

Sonstiges: 

Die Subitems sind aufsteigend von 0 an numeriert. 

Referenz: 

Siehe auch Kapitel 7.3 Die Abfrage von Menüs, 
MENUNUM, ITEMNUM 
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7.2 Subitems, Command-Tasten, Grafiken 
und MutualExclude 

Soll ein Item weitere Subitems besitzen, so trägt man einfach in die 
Menultem-Structure in Subitem den Zeiger auf die Menultem-Structure des 
Subitems ein. 

Soll einem Item eine alternative Tastensequenz zugeordnet werden, so trägt 
man das entsprechende Zeichen in »Command« in der Menultem-Structure 
des entsprechenden Items ein. Die Zeichensequenz besteht dann aus Amiga 
+ Zeichen. Zusätzlich muß noch das COMMSEQ-Flag gesetzt werden. 

Soll ein Item nicht als Text, sondern als Grafik dargestellt werden, so wird 
das ITEMTEXT-Flag nicht gesetzt und in ItemFill wird der Zeiger auf die 
Image-Structure der Grafik eingetragen, die das Item repräsentiert. Soll die¬ 
ses Item dann durch eine andere Grafik dargestellt werden, wenn der Maus¬ 
zeiger über ihm steht, so ist das Flag HIGHIMAGE zu setzen und in 
SelectFill der Zeiger auf das alternative Image einzutragen. 

In der Menu-Item-Structure gibt es einen Eintrag, der MutualExclude (ge¬ 
genseitiger Ausschluß) genannt wird. An dieser Stelle kann ein Eintrag vor¬ 
genommen werden, der beschreibt, welche Items sich untereinander bedin¬ 
gen. Dies ist natürlich nur bei Items sinnvoll, die Attribute darstellen. 

Wie MutualExclude gesetzt wird, wollen wir anhand eines Beispiels darlegen: 

MutualExclude ist bitweise zu betrachten. Bit 0 bezieht sich auf das erste 
Item in dem Menükasten. Bit 1 auf das zweite usw. 

Wir haben nun drei Items in dem Menükasten stehen. Item 2 und Item 3 
dürfen gleichzeitig »eingeschaltet« sein. Ist Item 3 eingeschaltet, so darf kein 
weiteres eingeschaltet werden. Ebenso darf Item 3 nicht eingeschaltet wer¬ 
den, wenn Item 1 oder 2 eingeschaltet sind. Daraus folgt: 

für Item 1: 000000000000100 - 0x0004 

für Item 2: 000000000000100 » 0x0004 

für Item 5: 111111111111011 - 0xFFFB 

Diese Werte müssen nun in die MutualExclude-Felder der entsprechenden 
Menultem-Structures eingetragen werden. 
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7.3 Die Abfrage von Menüs 

Die Abfrage von Menüs geschieht über die Window-Structure des Windows, 
zu dem die Menüs gehören. 

Wie schon von vorhergehenden Demonstrationen her bekannt, muß zuerst 
über das Window abgefragt werden, ob eine Menüauswahl stattgefunden hat: 

lftmessage » (struct IntuiMessage *) GetMsgtwindowptr-MJserPort)) 

{ 

MessageClass = message->Class; /* Messagemußgerettet «/ 

Code * uessage->Code; /* werden, da sie durch «/ 

ReplyMsg(nessage); /*Reply zerstört werden */ 

if(MesageClass -* MENUPICK) menu(); /» Sprung zur eigenen */ 

}; /» Menüabfrage s.u. */ 

MENUPICK ist ein IDCMP-Flag. Auf eben diese Weise kann auch jede 
andere Meldung abgefragt werden. Dabei ist dann natürlich nicht nach 
MENUPICK zu fragen, sondern nach dem entsprechenden anderen Flag. 

Anschließend folgt nun die Auswertung. Diese kann bei den Menüs nach 
zwei verschiedenen Methoden geschehen: 

1. Es wird die Menü- und die Itemnummer über MENUNUM(code) und 
ITEMNUM(code) ermittelt. Wenn die von MENUNUM ermittelte 
Nummer nicht gleich MENUNULL ist, wird anschließend die Adresse 
der Menultem-Structure des angewählten Items mittels ItemAdress 
ermittelt. 'Diese Adresse ist dann mit den Adressen der eigenen 
Menultem-Structures zu vergleichen, bis die richtige herausgefunden ist. 

Der Nachteil dieser Methode liegt darin, daß die Subitems dadurch nicht 
abgefragt werden können. 

2. Zum anderen kann direkt mit den Nummern gearbeitet werden, die 
Intuition den Menüs, Items und Subitems gibt. Die Menüs, Items und 
Subitems werden in der Reihenfolge numeriert, in der sie auf dem 
Schirm erscheinen. Jeweils mit 0 beginnend und von oben nach unten 
bzw. von links nach rechts. 

Wenn also ein Menü mit drei Menüoberpunkten erstellt wird, wovon das 
erste zwei, das zweite ein und das dritte drei Item hat, sieht die Abfrage 
folgendermaßen aus: 
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Zusätzlich gehen wir noch davon aus, daß das zweite Item des dritten 
Menüs ein Subitem hat. 

menu() 

{ 

lf(MENUNUM(code) t- MENUNULL) 
svltch(MENUNUM(code)) 

{ 

case 0: svltchfITEMNUM(code)) 

{ 

case 0: 

case 1: 

); 

case 1: svitch(ITEMNUM(code)) 

{ 

case 0: 

); 

case 2: svitch(ITEMNUM(code)) 

{ 

case 0: 

case 1: svltch(SUBNUM(code)) 

{ 

case 0: 

); 


Hinter den Case-Anweisungen und der entsprechenden Nummer können 
nun die entsprechenden Befehle oder Funktionsaufrufe stehen, die nach 
Betätigung des Items ausgeführt werden sollen. 
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1 /#*#*#*#**#****#*####**#****#*** 


Menue - Demonstration 
last update 26/05/87 
von Joerg Koch und Frank Kremser 
(c) Markt & Technik 1987 

**##*#*#****#***#********#****** 


10 

□effnet verschieden Menues 

und 

zeigt die unterschiedliche 

11 

der Menues 



12 




13 

**#*#**#**###*********#********/ 

14 




15 

#include <exec/types.h> 


/* Include - Files */ 

16 

#include <exec/memory.h> 



17 

#include <intuition/intuition.h> 

18 




19 

struct IntuitionBase #IntuitlonBase; /* Lib/Window-Zeiger 

20 

struct GfxBase *GfxBase; 


21 

struct Window #w; 



22 




23 

UWGRD imageC] = 


/# Disk / Image -fuer Ment 

24 

< 



25 

0x8001, 



26 

0X7FFE, 



27 

0X7FFE, 



28 

0X7C3E, 



29 

0X6006, 



30 

0X7C3E, 



31 

0X7FF2, 



32 

0X7FFE, 



33 

0X8001 



34 

>; 



35 




36 

struct Image image31 = 

/* 

Image Struktur */ 

37 

i 



38 

0, 

/* 

Linke Ecke #/ 

39 

o, 

/* 

obere Ecke */ 

40 

16, 

/* 

Breite */ 

41 

9, 

/* 

Hoehe #/ 

42 

1 . 

/* 

Tie-fe */ 

43 

&imageC0D, 

/* 

Zeiger auf Image-Data #/ 

44 

1 , 

/* 

Plane Pick */ 

45 

0, 

/* 

Plane Gnüf-f */ 

46 

NULL 

/* 

Naechstes Image */ 

47 

>; 



48 




49 

struct Menuitem item31 = 

/* 

MenuItem Struktur %/ 

90 

i 



51 

NULL, 

/* 

naechstes Menuitem */ 

52 

- 5 , 

/* 

linke Ecke */ 

53 

0, 

/* 

obere Ecke */ 

54 

50, 

/* 

Breite #/ 

55 

11 , 

/* 

Hoehe */ 

56 

ITEMENABLEDIHIGHC0MP, 

/* 

Flags */ 

57 

0, 

/* 

MutalExclude */ 

58 

(APTR) &image31, 

/* 

ImageData #/ 

59 

NULL, 

/* 

Command Key %/ 

60 

NULL, 



61 

NULL 



62 

>; 



63 




64 

struct Menu menu3 = 

/* 

Menu / Struktur %/ 
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65 

i 



66 

NULL, 

/* 

naechstes Menu %/ 

67 

300, 

/* 

linke Ecke */ 

68 

0, 

/* 

obere Ecke #/ 

69 

50, 

/% 

Breite */ 

70 

10, 

/% 

Hoehe */ 

71 

MENUENABLED, 

/% 

Flags %/ 

72 

"Grafik", 

/% 

Menu-Name */ 

73 

&item31 

/% 

Erstes Menuitem %/ 

74 

>; 



75 




76 

struct IntuiText text21 = 

/% 

IntuiText Struktur #/ 

77 

{ 



78 

0, 

/* 

DetailPen */ 

79 

1. 

/# 

BlockPen */ 

80 

JAM1, 

/* 

DrawMode %/ 

81 

o, 

/* 

Linke Ecke */ 

82 

0, 

/* 

Obere Ecke #/ 

83 

NULL, 



84 

(UBYTE *> "Joerg Koch", 

/* 

Text */ 

85 

NULL 

/# 

Zeiger auf naechsten IntuiText #/ 

86 

>; 



87 




88 

struct IntuiText text22 = 



89 




90 

o, 



91 

1. 



92 

JAM1, 



93 

0, 



94 

0, 



95 

NULL, 



96 

(UBYTE #> "Frank Kremser". 



97 

NULL 



98 

>; 



99 




100 

struct MenuItem item21 = 



101 

C 



102 

NULL, 



103 

“5, 



104 

22, 



105 

116, 



106 

11. 



107 

CHECK IT:itemtext:itemenabled:highbox, 

108 

0, 



109 

<£PTR) &text21. 



110 

NULL, 



111 

NULL, 



112 

NULL 



113 

>; 



114 




115 

struct MenuItem item22 = 



116 

C 



117 

&item21, 



118 

-5, 



119 

0, 



120 

116, 



121 

11. 



122 

1TEMTEXT!ITEMENABLED \ HIGHBOX, 


123 

0, 



124 

(APTR) &text22, 



125 

NULL, 



126 

NULL, 



127 

NULL 



128 

>; 
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129 

130 struct Menu menu2 = 

131 { 

132 &menu3, 

133 150, 

134 0, 

135 120, 

136 10, 

137 MENUENABLED, 

138 "Demo von", 

139 &item22 

140 >; 

141 

142 struct IntuiText textil = 

143 t 

144 0, 

145 1, 

146 JAM1, 

147 0, 

148 0, 

149 NULL, 

150 (UBYTE *) "Menu-Demo", 

151 NULL 

152 >; 

153 

154 struct IntuiText textl2 = 

155 { 

156 0, 

157 1, 

158 JAM1, 

159 0, 

160 0, 

161 NULL, 

162 (UBYTE *) "Programmende", 

163 NULL 

164 >; 

165 

166 struct IntuiText subtext = 

167 { 

168 0, 

169 1, 

170 J^l, 

171 0, 

172 0, 

173 NULL, 

174 (UBYTE *0^"Ende Aq", /* wird die Tastenkombination 

175 NULL /* betaetigt, so beendet dies 

176 >; 

177 

178 struct MenuItem subitem = 

179 < 

180 NULL, 

181 60, 

182 10, 

183 116, 

184 11, 

185 ITEMTEX T!ITEMENABLED!HIGHCOMP, 

186 0, 

187 (APTR) fcsubtext, 

188 NULL, 

189 113, 

190 NULL, 

191 NULL 

192 >; 


Amiga + q */ 
das Programm %/ 
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193 

194 

195 

196 

197 

198 

199 

200 
201 
202 

203 

204 

205 

206 

207 

208 

209 

210 
211 
212 

213 

214 

215 

216 

217 

218 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 

250 

251 

252 

253 

254 

255 

256 


struct MenuItem item12 = 

< 

NULL, 

-5, 

0 , 

116, 

H, 

ITEMTEXTIITEMENABLEDJHIGHCOMP, 

0 , 

(APTR) &textl2, 

NULL, 

NULL, 

&subitem, 

NULL 

>; 


struct Menuitem itemll = 

{ 

&iteml2, 

-5, 

22 , 

116, 

U» 

ITEMTEXT: I TEMENABLED! HI GHCOMP, 

0, 

(APTR) Ätextll, 

NULL, 

NULL, 

NULL 

>; 


struct Menu menul = 

< 

&menu2, 

10 , 

0, 

120 , 

10 , 

MENUENABLED, 
"Programmende", 
&iteml1 
>; 


struct NewWindow nw 
i 

0 , 

0, 

640, 

256, 

0, 

1, 

MENUPICK, 


/# NewWindow / Struktur */ 

/* Linke Ecke #/ 

/* Obere Ecke #/ 

/* Breite t/ 

/% Hoehe %/ 

/* DetailPen */ 

/% BlockPen #/ 

/* IDCMP-F1ags */ 


ACTIVATEiWINIXWDEPTHIWINDOWDRAGINGCAREREFRESH, /* Flags */ 
NULL, 

NULL, 

NULL, 

NULL, 

NULL, 

0 , 

0, 

0, 

0, 

WBENCHSCREEN 


/* Screen Typ #/ 
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257 

258 

259 

260 
261 
262 

263 

264 

265 

266 

267 

268 

269 

270 

271 

272 

273 

274 

275 

276 

277 

278 

279 

280 
281 
282 

283 

284 

285 

286 

287 

288 

289 

290 

291 

292 

293 

294 

295 

296 

297 

298 

299 

300 

301 

302 

303 

304 

305 

306 

307 

308 

309 

310 

311 

312 

313 

314 

315 

316 

317 


); 

struct IntuiMessage *message; 

ULONG MessageC1ass; 

USHGRT code; 

main() 

(■ /# Oe-f-fnen der Libs */ 

IntuitionBase = (struct IntuitionBase *) 

OpenLibrary("intuition.library",0L); 
i-f (IntuitionBase = NULL) exit(); 

G-fxBase = (struct G-fxBase *) OpenLibrary ( "graphics. library" , OL); 
i-f (G-fxBase = NULL) exit(); 

/* Def-fnen des Window */ 
w = (struct Window *) OpenWindow(&nw); 
i -f (w == NULL) ex i t (); 

SetMenuStrip(w,&menul); /* Setzen des Menues */ 

*or(;;) /* Endlosschlei-fe */ 

i-f(message = (struct IntuiMessage * )GetMsg(w->UserPort)) 

( /% Message abwarten und Auswerten #/ 

MessageClass = message->Class; /% Message retten */ 
code = message->Code; 

ReplyMsg(message); /* Wenn Menu angewaehlt, dann menu() */ 

i-f (MessageClass — MENUPICK) menu(); 

>; 

> 

menu() 

( /* Wenn regulaeres Menu angewaehlt, dann..*/ 

l + (PENUNUM(code) 1= MENUNULL) 

switch(MENUNUM(code) ) /* Welches Menue wurde Ausgewaehlt ' ? ??' ? ? */ 
i 

case 0: switch< ITEMNUM(code) )/*Welches Item ?'??'?? */ 

{ 

case 0: break; 

case 1: switch(SUBNUM(code)) 

case 0: CloseWindow(w); 

CloseLibrary(G-fxBase); 

CloseLibrary(IntuitionBase); 
exit(); 
break; 

>; 

>; 

break; 

case 1: switch(ITEMNUM(code)) 

{ 

case 0: break; 
case 1: break; 

>; 

break; 

case 2: switch(ITEMNUM(code)) 

< 

case 0: break; 

); 

break; 

>; 
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Die Gadgets 


Das Gadget, wörtlich übersetzt Dingsda bzw. Apparat, ist ein sehr nützliches, 
von Intuition bereitgestelltes Hilfsmittel, welches die Bedienung von Pro¬ 
grammen, Windows oder Screens mit der Maus unkompliziert und bedie¬ 
nungsfreundlich macht. 

Bei Gadgets bestehen zwei Möglichkeiten, sie einzusetzen. Zum einen kön¬ 
nen sogenannte System-Gadgets in einem eigenen Programm eingesetzt 
werden. Solche sind z.B. die Schließ- und Zurück-Gadgets von Windows. Die 
zweite Möglichkeit ist die Verwendung von selbstdefinierten Gadgets. Diese 
bieten besondere Reize. Da der Programmierer zwischen vier verschiedenen 
Grundtypen auswählen kann, sind diese Gadgets besonders anpassungsfähig: 

BOOLEAN-Gadget 

Ja- oder Nein-Entscheidungen können mit einem Boolean-Gadget abgefragt 
werden. Dies sind sehr einfache Gadgets, die durch Verwendung eigener 
Images (Grafiken) faszinierende Effekte in eigenen Programmen hervor- 
rufen. So kann z.B. das Image ein Schalter sein, der dann bei Betätigung 
durch das Anklicken mit der Maus in eine andere Stellung springt und bei 
Abfrage »Ja = Schalter betätigt«, »Nein = Schalter nicht betätigt« 
beispielsweise zwischen 60 oder 80 Zeichen pro Zeile umschaltet. 

PROPORTIONAL-Gadget 

Soll sich ein Wert mit dem Verschieben eines Gadgets verändern, so bietet 
sich die Verwendung von Proportional-Gadgets an. Ein Beispiel hierfür sind 
die allseits bekannten Schiebe-Regler für Farb-Werte. 
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TEXT-Gadgets 

Gadgets bieten auch die Möglichkeit der Eingabe von Texten. Hier wird zwi¬ 
schen String-Gadgets und Integer-Gadgets unterschieden. Mit String- 
Gadgets kann der Anwender verschiedene Texte übergeben, wobei ihm eine 
begrenzte Anzahl von Editier-Funktionen zur Verfügung stehen. Integer- 
Gadgets sind eine Abwandlung der String-Gadgets. Bei Integer-Gadgets 
können aber nur, wie der Name schon sagt, Integer-Werte übergeben wer¬ 
den. 

SYSTEM-Gadgets 

Zu diesen selbst definierbaren Gadgets kommen noch die schon erwähnten 
System-Gadgets. Diese werden automatisch von Intuition an den jeweiligen 
Screen oder je nach Wunsch an die jeweilige Window »geheftet«. Sie haben 
eine feste Position und können in ihrer Funktion nicht verändert werden. 
Auch ihr Aussehen ist immer gleich. Nähere Informationen zu diesen 
Gadgets finden Sie im Kapitel Window-Gadgets. 
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8.1 Die Gadget-Structure 

Um mit den Gadgets arbeiten zu können, muß zunächst eine allgemeine 

Structure, die für alle Gadget-Typen gleich ist, an Intuition übergeben wer¬ 
den: 

struct Gadget 

{ 

struct Gadget «NextGadget; 

SHORT LeftEdge, TopEdge, Hidth, Height; 

USHORT Flags; 

USHORT Activation; 

USHORT GadgetType 

APTR GadgetRender; 

APTR SelectRender; 

struct IntuiText »GadgetText; 

LONG MutualExclude; 

APTR Speciallnfo; 

USHORT GadgetID; 

APTR User; 

) 

NextGadget: Hier muß der Pointer auf die nächste Gadget- 

Structure eingetragen werden. Wenn dies aber das 
letzte Gadget in dieser Liste ist, so muß diese 
Variable auf »NULL« gesetzt werden. 

LeftEdge, TopEdge 

Width, Height: Diese vier Variablen legen die Position und Di¬ 

mension des jeweiligen Gadgets fest, die es in 
einem Requester oder Window annehmen soll. 
Durch Setzen eines bestimmten Flags in der 
Variable »Flags« können die Werte jeweils vom 
linken, oberen Rand oder aber vom rechten, 
unteren Rand aus angegeben werden. 

LeftEdge gibt die horizontale Position des Gadgets 
in Bezug auf das jeweilige Window oder Requester 
an. 

Wird die Variable GRELRIGHT in Flags gesetzt, 
so muß LeftEdge einen negativen Wert von z.B. -10 
annehmen. Das Gadget wird dann 10 Pixels von 
dem augenblicklichen rechten Rand des 
Requesters oder Windows gezeichnet. Ist 
GRELRIGHT nicht gesetzt, so muß LeftEdge 
positiv sein. Dann wird das Gadget vom linken 
Rand aus gezeichnet. 
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Flags: 


TopEdge gibt die vertikale Position des Gadgets 
an. 

Wenn das Gadget vom unteren Ende des z.B. 
Windows gezeichnet werden soll, muß in Flags das 
Flag GRELBOTTOM gesetzt sein. TopEdge muß 
dazu natürlich negativ angegeben werden. Wird 
GRELBOTTOM nicht gesetzt, so muß TopEdge 
positiv sein. Die Position des Gadgets richtet sich 
dann nach dem oberen Rand des Windows oder 
Screens. 

Width und Height geben die Breite und Höhe des 
Gadgets an. Ob die Werte positiv oder negativ sein 
müssen, wird in Flags durch Setzen der Flags 
GRELWIDTH und GRELHEIGHT angegeben. 
Ist eines der Flags gesetzt, so muß der entspre¬ 
chende Wert negativ angegeben werden. 

Sind die Werte negativ und die Flags sind gesetzt, 
verändert sich die Größe des Gadgets in Bezug auf 
die Größe des Windows. Sind die Werte positiv 
und die Flags nicht gesetzt, bleibt das Gadget in 
seiner Größe unverändert, auch wenn das Window 
verändert wird. 

Durch das Setzen von verschiedenen Flags können 
die Eigenschaften von Gadgets festgelegt werden : 

Was beim Anklicken des Gadgets passieren soll, 
wird durch zwei GADGHIGHBITS-Flags fest¬ 
gelegt. Es bestehen vier verschiedene Kombina¬ 
tionsmöglichkeiten, von denen nur eine verwendet 
werden darf: 

GADGHCOMP: Dieses Flag sagt aus, 

daß beim Anklicken des 
Gadgets alle nicht dar¬ 
gestellten Bits gezeigt 
werden. 

GADGHBOX: Wird das Gadget an¬ 

geklickt, so wird eine 
Box um das Gadget ge¬ 
zeichnet. 
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GADGHIMAGE: 

Wenn das Gadget an¬ 
geklickt wird, so weist 
dieses Flag darauf hin, 
das nun ein neues Image 
oder Border gezeichnet 
werden soll. 

GADGHNONE: 

Dieses Flag muß gesetzt 
sein, wenn kein Verän¬ 
dern des Gadgets beim 
Anklicken durch die 
Maus erwünscht wird. 

Folgende Flags bestimmen das Aussehen, sowie 
das Verhalten der Göße der Gadgets : 

GADGIMAGE: 

Flag muß gesetzt sein, 
wenn GadgetRender 

nicht auf »NULL« ge¬ 
setzt wird. 

GRELBOTTOM, 

GRELRIGHT, 

GRELWIDTH, 

GRELHEIGHT: 

Diese vier Flags geben 
die Größe und Position 
des Gadgets im Bezug 
z.B. auf ein Window 
wieder. Siehe TopEdge, 
LeftEdge, Width und 
Height. 

SELECTED: 

Mit diesem Flag kann 
der Anfangszustand des 
Activation-Flags 
TOGGLESELCT be¬ 
stimmt werden. Ist 
SELECTED gesetzt, so 
wird das Gadget im an¬ 
geklickten Zustand dar¬ 
gestellt. 
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Activation: 


GADGDISABLED: Wenn dieses Flag ge¬ 

setzt ist, wird das 
Gadget nicht dargestellt. 
Der Zustand dieses 
Flags kann mit den Be¬ 
fehlen OffGadget und 
OnGadget geändert 
werden. 

Hier können verschiedene Flags gesetzt werden, 
die die Benutzung und Aktivation der Gadgets be¬ 
schreiben : 


TOGGLESELECT: 


GADGIMMEDIATE: 


Ist dieses Flag gesetzt, 
so wechselt das Aus¬ 
sehen des Gadgets mit 
dem Anklicken der 
Maus. Der Anfangs¬ 
zustand des Gadgets 
kann durch das Flag 
SELECTED in Flags 
bestimmt werden. 

Ist dieses Flag gesetzt, 
wird dem Programm 
ständig mitgeteilt, ob das 
Gadget angeklickt ist. 
Dabei muß nicht unbe¬ 
dingt der Mauszeiger 
über dem Gadget sein. 
Nur das Setzen dieses 
Flags reicht nicht aus, 
um 100 prozentig sicher 
zu sein, daß der Benut¬ 
zer das Gadget betätigt 
hat. 

Ein zusätzliches Setzen 
von RELVERIFY 
schafft da Sicherheit. 
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RELVERIFY: 

Dem Programm wird 
das Anklicken des 
Gadgets nur dann mit¬ 
geteilt, wenn sich dabei 
der Mauszeiger über 
dem Gadget befindet. 

ENDGADGET: 

Dieses Flag wird nur bei 
Requesters benutzt. 

Wird ein Gadget mit 
diesem Flag betätigt, so 
verschwindet das jewei¬ 
lige Requester. 

FOLLOWMOUSE: 

Wird ein Gadget mit 
diesem Flag betätigt, so 
erhält das Programm die 
Position der Maus und 
das Gadget wird mit 
dem Mauszeiger ver¬ 
schoben. 

Diese vier Flags werden 
eingesetzt: 

in Bezug auf Windows 

RIGHTBORDER: 

Das Gadget wird in die 
rechte Umrandung ein¬ 
gesetzt. 

LEFTBORDER: 

Das Gadget wird in die 
linke Umrandung ein¬ 
gesetzt. 

BOTTOMBORDER: 

Das Gadget wird in die 
untere Umrandung ein¬ 
gesetzt. 

TOPBORDER: 

Das Gadget wird in die 
obere Umrandung ein¬ 
gesetzt. 

Die nächsten vier Flags sind wichtig bei der Ver¬ 
wendung von String-Gadgets: 

STRINGRIGHT: 

Wenn das String-Gadget 
angeklickt ist, wird der 
Text rechtsbündig dar¬ 
gestellt. 
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GadgetType: 


GadgetRender: 


STRINGCENTER: 

Wenn das String-Gadget 
angeklickt ist, wird der 
Text mittig dargestellt. 

LONGINT: 

Ist dieses Flag gesetzt, 
kann der Anwender in 
dem jeweiligen String- 
Gadget 32-Bit Integer- 
Zahlen eingeben. 

ALTKEYMAP: 

Dieses Flag muß gesetzt 
sein, wenn ein eigenes 
Key-Map in der 

Stringlnfo-Structure ver¬ 
wendet wird. 

GadgetType gibt den 
Gadgets an: 

Typ des verwendeten 

BOOLGADGET: 

Dieses Flag setzt ein 
Wahr- oder Falsch- 
Gadget. 

STRGADGET: 

Dieses Flag setzt ein 
String/Integer-Gadget. 

PROPGADGET: 

Dieses Flag setzt ein 
Proportional-Gadget. 

GZZGADGET: 

Dieses Flag setzt ein 
Gadget in einem 

Gimmezerozero- 
Window. 

REQGADGET: 

Dieses Flag setzt ein 
Gadget, das in einem 
Requester verwendet 

werden soll. 


Wenn GADGHIMAGE bei Flags gesetzt ist, muß 
hier der Pointer auf das jeweilige Image oder 
Border eingetragen werden. Andernfalls ist die 
Variable »NULL«. Dieses Image wird gezeigt, 
wenn das Gadget nicht aktiviert ist. 
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SelectRender: 

GadgetText: 

MutualExclude: 

Speciallnfo: 

GadgetID: 

User: 


Wenn GADGHIMAGE bei Flags gesetzt ist, muß 
hier der Pointer auf das jeweilige Image oder 
Border eingetragen werden. Andernfalls ist die 
Variable »NULL«. Dieses Image wird gezeigt, 
wenn das Gadget aktiviert ist. 

Wenn Text bei der Darstellung des Gadgets ver¬ 
wendet werden soll, muß hier der Pointer auf die 
jeweilige IntuitionText-Structure eingetragen wer¬ 
den. Die Koordinaten des Textes beziehen sich auf 
die Größe des Gadgets. 

Hier kann beschrieben werden, welche Gadgets 
sich untereinander bedingen. 

Wird ein Proportional- oder Text/Integer-Gadget 
verwendet, muß hier der Pointer auf die Proplnfo- 
bzw. Stringlnfo-Structure eingetragen werden. 
Andernfalls ist diese Variable »NULL«. 

Hier wird die Gadget-Identität eingetragen, die 
später abgefragt und somit herausgefunden werden 
kann, welches Gadget betätigt wurde. Die Gadget- 
Identität besteht aus einer Nummer. 

Hier kann ein Pointer auf eigene spezielle Daten 
eingetragen werden. 
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8.2 Das Boolean-Gadget 

Das Boolean-Gadget ist eines der simpelsten Gadgets, die Intuition zur 
Verfügung stellt. Mit ihm können zwei Zustände abgefragt werden: »Wahr«, 
das Gadget wurde angeklickt und »Falsch«, das Gadget wurde nicht 
angeklickt. 

Bei der Verwendung von Boolean-Gadgets wird nur die Gadget-Structure 
benötigt. Die Verwendung von Boolean-Gadgets wird in der Gadget- 
Structure in der Variable »Gadgetype« durch Setzen des BOOLGADGET- 
Flag festgelegt. 

Wenn der Benutzer das Boolean-Gadget mit der Maus angeklickt hat, beste¬ 
hen verschiedene Möglichkeiten, diesen aktivierten Zustand darzustellen: 

Durch Setzen des Flags GADGHBOX in der Variable Flags der Gadget- 
Structure wird eine einfache Border um die Gadget-Box gezeichnet. 

Wenn das Flag GADGHCOMP in der Variable Flags gesetzt wird, werden 
alle Bits des Gadgets komplementiert, wenn es aktiviert wurde. 

Das Flag GADGHIMAGE weist darauf hin, daß bei Aktivierung des 
Gadgets ein neues Image gezeichnet werden soll. 

Wird GADGHNONE in der Variable Flags eingetragen, findet keine Verän¬ 
derung statt. 

Wird in der Variable »Activation« der Gadget-Stucture das 
TOGGLESELECT-Flag nicht gesetzt, so werden die obengenannten Verän¬ 
derungen nur kurz, d.h. so lange wie der Benutzer die Maustaste beim 
Selektieren des Gadgets gedrückt hat, angezeigt. Durch Setzen dieses Flags 
wechselt der Zustand des Gadgets nach jedem Anklicken mit der Maustaste. 
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8.3 Das Text/Integer-Gadget 


Für die Benutzung von Text- bzw. Integer-Gadgets muß die bisher kennen¬ 
gelernte Gadget-Structure durch eine zusätzliche Structure erweitert werden, 
die Stringlnfo-Structure. Der Pointer auf diese Structure muß in der Gadget- 
Structure bei Speciallnfo eingetragen werden. Zudem muß in GadgetType 
STRGADGET stehen. Möchte man ein Integer-Gadget verwenden, so wird 
dies durch das zusätzliche Setzen des Flags LONGINT in der Variable 
Activation der Gadget-Structure festgelegt. 

struct Stringinfo 
{ 

UBYTE »Buffer; 

UBYTE »UndoBuffer; 

SHORT BufferPos; 

SHORT MaxChars; 

SHORT DispPos; 

SHORT UndoPos; 

SHORT NumChars; 

SHORT DlspCount; 

SHORT CLeft, CTop; 
struct Layer »LayerPtr; 

LONG Longlnt; 

struct Keyttap »AltKeyMap; 

); 


Buffer: 


UndoBuffer: 


BufferPos: 


MaxChars: 


DispPos: 


Hier muß ein Pointer zu einem Puffer eingetragen 
werden, der den jeweiligen String aufnehmen soll. 
Der muß O-terminated sein, also mit 0 enden. 

Hier muß ein Pointer zu einem Puffer eingetragen 
werden, der so lang ist, wie der Puffer für den 
jeweiligen String. Der UndoBuffer ermöglicht, die 
augenblickliche Eingabe rückgänig zu machen. 

Diese Variable gibt die darzustellende Position des 
Cursors an, wenn der jeweilige String initialisiert 
ist. 

Hier muß die maximale Anzahl der Buch¬ 
staben/Zahlen eingetragen werden, inklusive der 0 
am Ende, da der String »O-terminated« sein muß. 

DispPos gibt die Buffer-Position der ersten darzu¬ 
stellenden Zahl bzw. Buchstaben an. 


Diese Variablen werden von Intuition initialisiert: 

UndoPos: Gibt die Buchstaben/Zahlen-Position in dem 

UndoBuffer an. 
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NumChars: 

NumChars enthält die Anzahl der Buch¬ 
staben/Zahlen im Puffer. 

DispCount: 

Dies enthält die Anzahl der sichtbaren Buch¬ 
staben/Zahlen im String-Gadget, die auf dem Bild¬ 
schirm dargestellt werden. 

CLeft, CTop: 

Diese beiden Variablen enthalten die Position der 
Box in dem das String-Gadget enthalten ist. 

LayerPtr: 

Dies gibt den Layer (»Grafik-Schicht«) an, die das 
Gadget enthält. 

Longlnt: 

Wenn dies ein Integer-Gadget ist, enthält diese 
Variable die Integer-Zahl. 

AltKeyMap: 

Wenn kein eigenes KeyMap verwendet wird, muß 
hier »NULL« eingetragen werden.Andernfalls wird 
hier der Pointer auf das eigene KeyMap ein¬ 
getragen. Dazu muß das Activation-Flag 
ALTKEYMAP in der Gadget-Structure gesetzt 
sein. 


String-Gadgets erlauben dem Benutzer die Eingabe von Texten oder Zahlen. 
Es können mehrere Text- und Integer-Gadgets dargestellt werden. Aktiv 
kann nur jeweils eins sein. 

String-Gadgets können zwei Puffer enthalten. Einen Puffer für den einzu¬ 
gebenden String und einen für den zuletzt eingegebenen String, falls die Ein¬ 
gabe rückgänig gemacht werden soll. 

Wenn ein String-Gadget einen »UndoBuffer« enthält, so wird beim 
Anklicken des Text/Integer-Gadgets der dargestellte String in diesen Puffer 
kopiert. Verschiedene Tasten-Kombinationen bieten eine komfortable 
Editierung des Textes bzw. der Zahl: 


Rechte Amiga-Taste 
und Q: 

Rechte Amiga-Taste 
und X: 

I Return I : 

I Backspace | ; 

[HD: 

1 Shlft I Q oder 0: 


Macht die letzte Eingabe rückgänig. 

Löscht den Eingabe-Puffer. 

Beendet die Eingabe. 

Löscht die Buchstaben links vom Cursor. 

Löscht die Buchstaben unter dem Cursor. 

Bewegt den Cursor zum Anfang oder Ende des 
Gadgets. 
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(ZI oder Q: Bewegt den Cursor im Text nach links oder rechts. 

Durch zwei Flags kann der String, der auf dem Bildschirm dargestellt wird, 
justiert werden: 

Das Flag STRINGCENTER in der Variable Activation in der Gadget- 
Structure gibt an, daß der Text mittig dargestellt werden soll. 

Das Flag STRINGRIGHT justiert den Text rechtsbündig. 
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8.4 Das Proportional-Gadget 

Wenn Proportional-Gadgets verwendet werden sollen, muß die Gadget- 
Stucture um eine weitere Struktur, die Proplnfo-Structure, erweitert werden. 
Der Pointer dieser Structure, wird dann in die Variable Speciallnfo der 
Gadget-Structure eingetragen. Zudem muß in GadgetType PROPGADGET 
eingesetzt werden. 

struct Proplnfo 
( 

USHORT Flags; 

USHORT HorlzPot; 

USHORT VertPot; 

USHORT HorlzBody; 

USHORT VertBody; 

USHORT CWldth; 

USHORT CHeight; 

USHORT HPotRes, VPotRes; 

USHORT LeftBorder; 

USHORT TopBorder; 

); 

Flags: Durch die Eingabe von verschiedenen Flags kann 

das Aussehen und die Bewegung des Prop- 
Gadgets festgelegt werden: 

FREEHORIZ: Erlaubt die Bewegung in 

die horizontale Rich¬ 
tung. 

FREEVERT: Erlaubt die Bewegung in 

die vertikale Richtung. 

AUTOKNOB: Die Verwendung eines 

Auto-Knopfes. 

KNOBHIT: Dies wird von Intuition 

gesetzt, wenn der Knopf 
angeklickt wird. 

PROPBORDERLESS: Wenn dieses Flag 

gesetzt ist, wird keine 
Umrandung um das 
Gadget gezeichnet. 

HorizPot: Gibt die horizontale Position des Knopfes beim 

Initialisieren des Prop-HGadgets an. 

VertPot: Gibt die vertikale Position des Knopfes beim 

Initialisieren des Prop-Gadgets an. 
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HorizBody: Gibt die horizontale prozentuale Schrittweite in 

Bezug auf OxFFFF an. 

VertBody: Gibt die vertikale prozentuale Schrittweite im 

Bezug auf OxFFFF an. 

Diese Werte werden von Intuition gesetzt: 

CWidth: Breite des Raums in dem sich das Prop-Gadget 

bewegt. 

CHeight: Höhe des Raums in dem sich das Prop-Gadget 

bewegt. 

HPotRes, VPotRes: Erhöhung der vertikalen und horizontalen Werte. 

LeftBorder: Linker Rand des Proportional-Gadgets. 

TopBorder: Oberer Rand des Proportional-Gadgets. 

Proportional-Gadgets sind die flexibelsten Gadgets, die Intuition zur Verfü¬ 
gung stellt. Man kann mit Ihnen nicht nur Verhältnisse darstellen, sondern 
auch Gegenstände per Maus über den Bildschirm wandern lassen. 

Der Gegenstand, auch Knopf (englisch Knob) genannt, kann beliebige For¬ 
men durch die Definition eines eigenen Images annehmen. Durch Setzen des 
AUTOKNOB-Flags kann man aber auch einen vordefinierten Auto-Knopf 
verwenden. Er kann, durch das Setzen oder Nicht-Setzen der Flags 
FREEHORIZ und FREEVERT in der Proplnfo-Struktur, in alle Richtun¬ 
gen bewegt oder wie ein Farbregler horizontal bzw. vertikal verschoben 
werden. 

Sehr wichtig bei einem Proportional-Gadget ist die Angabe der Schrittweite. 
Die Schrittweite steht immer in einem gewissen Verhältnis zu der maximal 
und minimal möglichen Verschiebung auf dem Screen. Die kleinste Schritt¬ 
weite des Knopfes wird in den Variablen VertBody und HorizBody der 
Proplnfo-Structure eingegeben. Ein einfaches Beispiel für die Schrittweite 
bietet die Darstellung eines Farb-Reglers. Der Amiga kann maximal pro 
Farbwert 16 verschiedene Abstufungen annehmen. Das heißt, daß unser 
Gadget maximal 16 verschiedene Schritte haben darf, um eine optimale 
Farbabstufung darstellen zu können. HorizBody und VertBody kann maxi¬ 
mal einen Wert von 65536 annehmen (Hex = OxFFFF). Die kleinste Schritt¬ 
weite ist bei 16 Abstufungen dann 65536/16*1 = 4096 (0x1000). HorizBody 
muß somit, wenn es sich um einen horizontalen Farb-Regler handelt, den 
Wert 0x1000 annehmen. 

Wenn man beispielsweise einen Textpuffer, der 30 Zeilen enthält, darstellen 
will, auf dem Bildschirm aber nur 20 Zeilen dargestellt werden können, so 
sieht die Berechnung folgendermaßen aus: 65536/30*20 = 109,2 
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8.5 Die Abfrage von Gadgets 

Bei der Abfrage, welches Gadget nun betätigt wurde, bedient man sich der 
Hilfe von IntuiMessage, das die aktuellen Daten der Ein- und Ausgabe der 
»Schnittstelle« (IDCMP) übergibt. 

Wichtig bei unseren Gadgets ist, daß in GadgetID jeweils eine unterschied¬ 
liche Nummer steht, an der wir unser Gadget erkennen können. Wird ein 
Gadget nun betätigt und wir haben das Flag RELVERIFY in unserer 
Variable Activation der Gadget-Structure gesetzt, so erhalten wir von 
IntuiMessage das Gadget-Flag GADGETUP. Ist in unserer Gadget- 
Structure das Flag GADGIMMEDLATE gesetzt, so erhalten wir 
GADGETDOWN. Wenn diese Flags an der »Schnittstelle« vorhanden sind, 
brauchen wir nur noch IntuiMessage nach unserem Gadget-Pointer abzu¬ 
fragen. Wie wir dieses Flags von IntuiMessage abfragen, zeigt folgendes Bei¬ 
spiel: 

struct IntuiMessage »message; 

/* Endlosschleife */ 

for (;;) 

{ 

/» Nachricht Uber den, vom 

Window abgeleiteten Message-Port-Polnter holen */ 

lf (message » (struct IntuiMessage *)GetMsg(v->UserPort)) 

{ 

/* Parameter übernehmen und so lange varten, bis eine 
Nachricht am Port angekommen ist */ 

MessageClass * message->Class; 

Code - message->Code; 

ReplyMsg(message)j 

/» Nachricht ist am Port angekommen, unsere Nachricht ? 

Ja, dann Unterfunktion»/ 

svitch (MessageClass) 

{ 

case GADGETDOWN : 

case GADGETUP : Gad(message); 


/* Wenn BOOL - Variable Schluß = TRUE, dann Ausstieg aus 
der Endlosschleife. */ 
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lf (schluß = TRUE) 
exlt(); 

) 

/* Unterfunktion Gad(iness) */ 

Gad(mess) 

struct IntulHessage »mess; 

{ 

struct Gadget *gad; 
lnt gadld; 

/* Pointer zu meinem Gadget von Intulmessage holen */ 
gad ■ mess->IAddress; 

/* Gadget - Nummer holen */ 
gadld ■ gad->GadgetID; 

/* Sultch / Case abfrage, velches Gadget 0 oder 1, wenn 1 dann 
Ende */ 

svltch(gadid) 

{ 

case 0: 

break; 

case 1: Schluß * TRUE; 
break; 

}; 

) 

Sicherlich könnte man auch die Unterfunktion GadQ in der Endlosschleife, 
wo die Flags GADGETDOWN und GADGETUP abgefragt werden, mit 
unterbringen. Man muß jedoch dabei bedenken, daß dadurch das ganze 
Geschehen sehr unübersichtlich würde. 
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8.6 Die Gadget-Befehle 


8.6.1 AddGadget 

Syntax: pos = AddGadget(Window, Gadget, Position); 

Funktion: Hängt das jeweilige Gadget an die Gadget-Liste des jeweili- 



gen Window. 



Parameter: 

Window 

-> 

Zeiger auf die Window-Structure der 
Window, zu der das Gadget gehört. 


Gadget 

-> 

Zeiger auf die Gadget-Structure des 
Gadgets, das angefügt werden soll. 


Position 

-> 

Position, an der das Gadget eingefügt 
werden soll. 

Ergebnis: 

pos 

-> 

Position, an der das Gadget eingefügt 
worden ist. 


Datentyp: 


Sonstiges: 


Referenz: 


struct Window *Window; 
struct Gadget *Gadget; 
int Position; 
int pos; 

Soll das Gadget am Ende der Gadget-Liste stehen, so em¬ 
pfiehlt es sich, die Position auf -1 zu setzen. Werden System- 
gadgets verwendet, sind diese an erster Stelle in die Liste ein¬ 
zutragen. Zu beachten ist noch, daß AddGadget nur das 
jeweilige Gadget in die Liste einträgt und nicht auf dem 
Screen darstellt. Dafür muß der Befehl RefreshGadgets 
verwendet werden. 

Siehe auch RefreshGadget 


8.6.2 ModifyProp 

Syntax: ModifyProp(PropGadget, Pointer, Requester, Flags, 

HorizPot, VertPot, HorizBody, VertBody); 

Funktion: Diese Routine verändert die Parameter eines Proportional- 

Gadgets. 

Parameter: PropGadget -> Zeiger auf die Gadget-Structure des 

Proportional-Gadgets, das verändert 
werden soll. 
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Pointer -> Zeiger auf die Window-Structure, in 

dem sich das Prop-Gadget befindet. 

Requester -> Zeiger auf die Requester-Structure, in 
dem sich das Prop-Gadget befindet, 
falls es zu einem Requester gehört. 
Gehört das Gadget nicht in ein 
Requester, kann dieser Parameter auf 
NULL gesetzt werden 

Flags -> Neue Flags des Gadgets: 

AUTOKNOB = Verwendung des Standard- 

Knopfes. 

FREEHORIZ = Knopf, der horizontal bewegt 
werden kann. 

FREEVERT = Knopf, der vertikal bewegt 

werden kann. 

KNOBHIT = Dies wird von Intuition ge¬ 

setzt, falls der Knopf von der 
Maus angeklickt wird. 

PROPBORDER = Dies wird gesetzt, falls keine 

LESS Umrandung »Border« für 

das Gadget vorhanden ist. 

HorizPot -> gibt die horizontale Schrittweite des 

Knopfes in Prozent wieder. Beispiel: 

In 16 Schritten soll sich der Knopf 
bewegen, bei Variable mit 16 Bit 
Länge, dies entspricht gleich einer max. 
Zahlenlänge von 65535, berechnet sich 
der Wert wie folgt: 

65535 / 16 = 4096 

= > HorizProp = 4096 oder 0x1000 

VertPot -> wie HorizPot, nur vertikal. 

HorizBody-> horizontale Position des 

Knopfes nach der Installie¬ 
rung. 
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VertBody-> vertikale Position des 

Knopfes nach der Installie¬ 
rung. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct Gadget *PropGadget; 
struct Window *Pointer; 
struct Requester *Requester; 

WORD Flags, HorizPot, VertPot; 

WORD HorizBody, VertBody; 

Sonstiges: 

Anschließend muß noch der Befehl RefreshGadgets gegeben 
werden, um das geänderte Gadget darzustellen. 

Zur näheren Beschreibung der Proportional-Gadgets siehe 
Kapitel 8. 

Referenz: 

Siehe auch RefreshGadget. 

8.6.3 OfFGadget 

Syntax: 

OffGadget(Gadget, Pointer, Requester); 

Funktion: 

Diese Funktion schaltet das angegebene Gadget aus der spe¬ 
zifizierten Window-Structure, bzw. aus der Requester- 
Structure ab. 

Parameter: 

Gadget -> Zeiger auf die Gadget-Structure des 

Gadgets, das abgeschaltet werden soll. 

Pointer -> Zeiger auf die Window-Structure, in 

der das Gadget eingetragen ist. 

Requester -> Zeiger auf die Requester-Structure, in 

der das Gadget eingetragen ist. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct Gadget *Gadget; 
struct Window *Pointer; 
struct Requester *Requester; 

Sonstiges: 

Das durch OffGadget abgeschaltete Gadget kann durch 
OnGadget wieder eingeschaltet werden. 

Wird ein Gadget durch OffGadget gelöscht, so wird es nicht 
aus der Gadget-Liste ausgelöscht. 
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Befindet sich das Gadget in einem Window, muß 
»Requester« auf NULL gesetzt werden. Ist das Gadget ein 
Requester-Gadget, so muß »Pointer« gleich NULL sein. 

Referenz: Siehe auch OnGadget. 


8.6.4 OnGadget 


Syntax: OnGadget(Gadget, Pointer, Requester); 

Funktion: Schaltet ein, durch OffGadget abgeschaltetes, Gadget wieder 

ein. 


Parameter: 


Ergebnis: 

Datentyp: 


Sonstiges: 


Referenz: 


Gadget -> Zeiger auf die Gadget-Structure des 

Gadgets, das eingeschaltet werden soll. 

Pointer -> Zeiger auf die Window-Structure, in 

der das Gadget eingetragen ist. 

Requester -> Zeiger auf die Requester-Structure, in 
der das Gadget eingetragen ist. 

Kein Ergebnis. 

struct Gadget *Gadget; 
struct Window *Pointer; 
struct Requester * Requester; 

Das mit OnGadget eingeschaltete Gadget kann mit 
OffGadget wieder abgeschaltet werden. 

Siehe auch OffGadget. 


8.6.5 RefreshGadgets 

Syntax: RefreshGadget(Gadgets, Pointer, Requester); 

Funktion: Diese Funktion zeichnet und frischt alle Gadgets in der 

Gadgetliste auf, beginnend bei dem angegeben Gadget. 


Parameter: Gadget 

-> Zeiger auf das erste Gadget, das 
»refreshed« werden soll. 

Pointer 

-> Zeiger auf die Window-Structure des 
Windows, in dem sich die Gadgets be¬ 
finden. 

Requester 

-> Zeiger auf die Requester-Structure des 
Requesters, in dem sich die Gadgets 
befinden. 
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Ergebnis: 

Datentyp: 


Sonstiges: 


Referenz: 


Kein Ergebnis. 

struct Gadget *Gadget; 
struct Window *Pointer; 
struct Requester *Requester; 

Bevor RefreshGadget aufgerufen wird, müssen die jeweiligen 
Gadgets mit AddGadget in die GadgetListe eingetragen wer¬ 
den, sonst werden sie nachdem RefreshGadget aufgerufen 
wurde, nicht auf dem Screen dargestellt. 

Sollen alle Gadgets eines Windows, bzw. eines Requesters 
»refreshed« werden, so muß für Gadget folgender Ausdruck 
angegeben werden: 

WindowPtr -> FirstGadget 

Siehe auch OffGadgets 


8.6.6 RemoveGadget 

Syntax: Pos = RemoveGadget(Pointer, Gadget); 

Funktion: Löschen eines Gadgets aus der jeweiligen Window-Gadget- 



Liste. 


Parameter: 

Pointer 

-> Zeiger auf die Window-Structure des 
Windows, aus dem das Gadget gelöscht 
werden soll. 


Gadget 

-> Zeiger auf die Gadget-Structure des 
Gadgets, das gelöscht werden soll. 

Ergebnis: 

Pos 

-> Position, die das Gadget in der Liste 
hatte. 


Datentyp: struct Window *Pointer; 

struct Gadget *Gadget; 
int Pos; 

Sonstiges: Das Image des Gadgets wird durch diese Funktion nicht vom 

Schirm gelöscht. 

Referenz: Siehe auch AddGadget 
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1 /******************************* 

2 

3 Gadget-Demonstration 

4 last update 26/05/87 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt und Technik 1987 

7 

8 ******************************** 

9 

10 Diese Demonstration zeigt eine Auswahl an verschiedenen Gadgettypen. Mit den 

11 drei Proportionalgadgets kann die Hintergrund-farbe veraendert werden. 

12 

13 ******************************/ 

14 

15 #include 

16 #include 

17 #include 

18 #include 

19 #include 

20 #include 

21 ttinclude 

22 #include 

23 ttinclude 

24 ttinclude 

25 ttinclude 

26 #include 

27 ttinclude 

28 ttinclude 

29 #include 

30 ttinclude 

31 #include 

32 

33 struct IntuitionBase *IntuitionBase; /# Lib und ander Zeiger #/ 

34 struct GtxBase »GtxBase; 

35 struct IntuiMessage *message; 

36 struct RastPort *rp; 

37 struct Screen *screen; 

38 struct Window *w; 

39 

40 /* Image des benutzerdetinierbaren Gadgets */ 

41 

42 UWGRD custimageC D = 

43 i 

44 0x03C0, 0xlDF8, 0x3AFC, 0x6BFE, 0x65FE, 0x5BFE, OxEBFF, OxFFFF, 

45 OxFFFF, OxFFFF, 0x7FFE, 0x7FFE, 0x7FFE, 0x3FFC, OxlFFB, 0x03C0 

46 >; 

47 


48 

struct Image cus_image 

= /* 

Image Structure */ 

49 

{ 



50 

o, 

/* 

Linke Ecke */ 

51 

0, 

/* 

Obere Ecke */ 

52 

16, 

/* 

Breite #/ 

53 

16, 

/* 

Hoehe */ 

54 

1, 

/* 

Tie-fe */ 

55 

&custimageC0], 

/# 

Zeiger aut das Image */ 

56 

1, 

/* 

PlanePick */ 

57 

0, 

/* 

Planeonott #/ 

58 

NULL 

/* 

Zeiger aut weitere Images */ 

59 

>; 




60 

61 

62 struct IntuiText rtxt = 

63 ( 


<exec/types.h> /* Include-Files einiesen */ 

<exec/nodes.h> 

<exec/lists.h> 

<exec/ports.h> 

<exec/devices.h> 

<devices/keymap.h> 

<graphics/regions.h> 

<graphics/copper.h> 

<graphics/ge1s.h> 

<graphics/gtxbase.h> 

<graphics/gtx. h> 

<graphics/c1ip.h> 

<graphics/view.h> 

<graphics/rastport.h> 

<graphics/1ayers.h> 

<intuition/intuition.h> 

<hardware/blit.h> 


/* Text zu einem Gadget #/ 




224 Die Gadgets 


65 

1 , /* 

BlockPen %/ 

66 

JAM1, /* 

Draw-Mode */ 

67 

-35, /* 

Linke Ecke 

*/ 

68 

2, /* 

Obere Ecke 

*/ 

69 

0, /* 

Zeiger auf 

Zeichensatz */ 

70 

"Rot”, /* 

Text */ 


71 

0 /* 

Zeiger auf 

weitere Intuition-Texte */ 

72 

>; 



73 




74 

struct IntuiText gtxt = 



75 

{ 



76 

1, 



77 

1. 



78 

JAM1, 



79 

-35, 



80 

2, 



81 

0, 



82 

"GrCn", 



83 

0 



84 

>; 



85 




86 

struct IntuiText btxt = 



87 

< 



88 

1. 



89 

1. 



90 

JAM1, 



91 

-35, 



92 

2, 



93 

0, 



94 

"Blau", 



95 

0 



96 

>; 



97 




98 

struct IntuiText ntext = 



99 

< 



100 

1 , 



101 

1 , 



102 

JAMl, 



103 

10, 



104 

-11, 



105 

0, 



106 

"Texteingabe", 



107 

0 



108 

>; 



109 




110 

struct IntuiText cus_text = 



111 

< 



112 

1, 



113 

1, 



114 

JAMl, 



115 

2, 



116 

-11, 



117 

0, 



118 

"Benutzerdefiniertes-Gadget", 


119 

0 



120 

>» 



121 




122 

struct IntuiText bool_str = 



123 

{ 



124 

1 , 



125 

1 , 



126 

jmi , 



127 

9, 



128 

1 , 
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129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142 

143 

144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

155 

156 

157 

158 

159 

160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 


0 , 

“ENDE", 

0 

>; 


struct IntuiText bool2_str = 

< 

1 , 

1, 

JW1, 

9 , 

1 . 

0, 

"BEEP", 

0 

>; 

struct Image , g_img, b_img; 

struct Proplrvfo r_prop,g_prop,b_prop; 

struct Proplnfo cust_prop = /* Informationen zu dem Benutzer-Gadget %/ 

< 

FREEH0RIZ FREEVERTIPRCPBORDERLESS, /* frei beweglich */ 

0x8000, 

0x8000, 

0x800, 

0x800, 

150, 

50, 

1, 

1, 

0, 

0 

>; 

UBYTE DefStringC20] = "Markt & Technik"; 

UBYTE Undo C20D; 

struct StringInfo 

< 

DefString, 

Undo, 

0, 

20 , 

0, 

0, 

13, 

0, 

0, 

0, 

NULL, 

0, 

NULL 

>; 

USH0RT PairsCD = 

{ 

- 1 , 

/* Information describing the #/ 

201 , 

- 1 , 

201 , 

11, 

- 1 , 


TexString = /% Fuer Texte in Text-Gadgets */ 

/* Zeiger auf den Puffer #/ 

/* Zeiger auf den Undo-Puffer */ 

/* Startposition des Cursos */ 

/# Maximale Anzahl der Zeichen */ 

/* Zeiger auf den ersten Buchstaben im Puffer #/ 
/* Position des Cursors im Undo-Puffer */ 

/$ Anzahl der Zeichen im Puffer %/ 

/% Anzahl der sichtbaren Zeichen */ 

/# Linke Ecke %/ 

/% Obere Ecke %/ 

/# Layer-Pointer #/ 

/% Longint-Wert */ 

/* Alternatives Keyboard */ 


/% Startposition X */ 

/* Startposition Y */ 

/* Kleinst moegliche Schrittweite in X-Richtung %/ 
/% Kleinst moegliche Schrittweite in Y-Richtung %/ 
/% Reale Ausmasse des Kastens */ 

/% Schrittweite in X-Richtung */ 

/* Schrittweite in Y-Richtung #/ 

/* Linker Rand */ 

/* Rechter Rand %/ 


/* border around the gadget #/ 
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193 n, 

194 -1 , 

195 -1 

196 >s 

197 

198 USHORT Pairsin = 

199 { 

200 0 , 

201 0 , 

202 51, 

203 O, 

204 51, 

205 11, 

206 0, 

207 11, 

208 O, 

209 0 

210 ); 

211 

212 struct Border StrBorder = 

213 i 


214 

0, 


215 

o, 


216 

1, 


217 

0, 


218 

JAM1, 


219 

5, 


220 

&PairsC03, 


221 

NULL 


222 

223 

>; 


224 

struct Border butt_border = 


225 



226 

-1, 


227 

-1, 


228 

1, 


229 

0, 


230 

JAM1, 


231 

5, 


232 

&PairslC03, 


233 

NULL 


234 

235 

>; 


236 

struct Gadget blue_gad = 


237 

< 


238 

0, 

/* 

239 

50, 

/* 

240 

120, 

/* 

241 

200, 

/# 

242 

20, 

/* 

243 

GADGHC0MP, 

/* 

244 

GADGIMMEDIATEIRELVERIFY, 

/* 

245 

PROPGADGET, 

/* 

246 

<APTR)&b_img, 

/* 

247 

0, 

/* 

248 

&btxt, 

/* 

249 

0, 

/it¬ 

250 

(APTR)&b_prop, 

zt 

251 

0, 

/% 

252 

0 

Zt 

253 

254 

>; 


255 

struct Gadget green_gad = 


256 




/% Linke Ecke %/ 

/* Obere Ecke */ 

/* DetailPen #/ 

/# BlockPen #/ 

/% Drawmode #/ 

/% Anzahl der Koordinaten-Paare */ 
/# Zeiger auf die Paare #/ 

Zt Zeiger auf weitere Borders #/ 


Zeiger auf naechstes Badget tZ 
Linke Ecke */ 

Obere Ecke */ 

Breite */ 

Hoehe %/ 

Flags */ 

Activation */ 

Gadget-Typ */ 

Zeiger auf Image tZ 
Zeiger auf Se1ect-Image */ 

Text */ 

Mutual-Exclude */ 

Spezial-Information: Hier Proplnfo */ 
GadgetID */ 

UserData */ 
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257 &blue_gad, 

258 50, 

259 100, 

260 '200, 

261 20, 

262 GADGHCOMP, 

263 GADGIMMEDIATEIRELVERIFY, 

264 PROPGADGET, 

265 (APTR) &g _img, 

266 0, 

267 &gtxt, 

268 0, 

269 (APTR)&g_prop, 

270 1, 

271 0 

272 >; 

273 

274 struct Gadget red_gad = 

275 { 

276 &g reen _gad, 

277 50, 

278 80, 

279 200, 

280 20, 

281 GADGHCOMP, 

282 GADGIMMEDIATE!RELVERIFY, 

283 PROPGADGET, 

284 (APTR)&r_img, 

285 0, 

286 &rtxt, 

287 0, 

288 (APTR)&r_prop, 

289 2, 

290 0 

291 >; 

292 

293 struct Gadget tex_gad = 

294 { 

295 &red_gad, 

296 50, 

297 50, 

298 200, 

299 20, 

300 GADGHCOT'P, 

301 STRINGCENTERIRELVERIFY, 

302 STRGADGET, 

303 (APTR)&StrBorder, 

304 0, 

305 &ntext, 

306 0, 

307 (APTR)&TexString, 

308 3, 

309 0 

310 >; 

311 

312 struct Gadget cust_knob = 

313 { 

314 &tex_gad, 

315 320, 

316 50, 

317 300, 

318 150, 

319 GADGHCOMP, 

320 GADGIMMEDIATEIRELVERIFY, 
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321 

322 

323 

324 

325 

326 

327 

328 

329 

330 

331 

332 

333 

334 

335 

336 

337 

338 

339 

340 

341 

342 

343 

344 

345 

346 

347 

348 

349 

350 

351 

352 

353 

354 

355 

356 

357 

358 

359 

360 

361 

362 

363 
.364 

365 

366 

367 

368 

369 

370 

371 

372 

373 

374 

375 

376 

377 

378 

379 

380 

381 

382 

383 

384 


PROPGADGET, 

(APTR)&cus_image, 

0, 

&cus_text, 

0 , 

(APTR)&cust_prop, 

4, 

0 

>; 

struct Gadget bool_gad = 

&cust_knob, 

51, 

159, 

50, 

10 , 

GADGHCQMP, 

GADGIMMEDIATE!RELVERIFY, 

BOOLGADGET, 

(APTR)&but t_border, 

0, 

&bool_str, 

0 , 

0, 

5 , 

0 

>; 

struct Gadget bool2_gad = 

{ 

&bool_gad, 

200 , 

159, 

50, 

10 , 

GADGHCOMP, 

TOGGLESELECT \ GADGIMMEDIATE!RELVERIFY, 
BOOLGADGET, 

(APTR)&butt_border, 

0 , 

&bool2_str, 

0, 

0, 

6 , 

0 

>; 


/# Linke Ecke */ 
/% Obere Ecke */ 
/% Breite */ 

/* Hoehe */ 

/* DetailPen #/ 
BlockPen */ 


struct NewWindow nw = 

< 

0 , 

0 , 

640, 

256, 

O, 

1 , /* 

REFRESHW1NDOW!MOUSEBUTTONS!MOUSEMOVE /* IDCf^F flags */ 

IGADGETDOWN \ GADGETUP, 

WINDOWDEPFHIWINDOWDRAGIREPORTMOUSE /* Flags */ 

I SMART_REFRESH, 

&bool2_gad, /* Zeiger au-f erstes Gadget des Windows */ 

NULL, /# Checkmark #/ 

"Gadget-Demonstration", /# Window-Titel %/ 

Nil, /* Zeiger au-f screen %/ 
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385 NULL, 

386 0, 

387 0, 

388 0, 

389 0, 

390 WBENCHSCREEN 

391 >; 

392 

393 BOGL ende; 

394 

395 

396 main() 

397 { 

398 ULONG MessageC1ass; 

399 USHORT code; 

400 /# Proplnfo der RGB-Gadgets setzen #/ 

401 r_prop.Flags = g_prop.Flags = b_prop.Flags = FREEHORIZ!AUTCKNÜB; 

402 rprop.HonzBody = g_prop.HorizBody = b_prop.HorizBody = 0x1000; 

403 r_prop.HorizPot = g_prop.HorizPot = b_prop.HorizPot — 0x0000; 

404 

405 if < ! (G-fxBase = (struct G-fxBase # )OpenLibrary ( "graphics. 1 ibrary" ,0) ) > 

406 ( /* Gra-fik-Bibliothek oeffnen #/ 

407 close_things(); 

408 exitO; 

409 > 

410 /# Intuition oeffnen #/ 

411 if(!(IntuitionBase = (struct IntuitionBase #) 

412 OpenLibrary("intuition.library",0))) 

413 < 

414 close_things(); 

415 exitO; 

416 > 

417 

418 i-f ( ! (w = (struct Window * )0penWindow(8fnw) )) /# Window oe-ffnen */ 

419 < 

420 close_things(); 

421 exitO; 

422 ) 

423 

424 rp = w->RPort; 

425 screen = w->WScreen; 

426 

427 SetRGB4(&screen->ViewPort,0,0,0,0); /* Hintergrund-farbe setzen %/ 

428 

429 Re-freshGadgets(&bool2_gad,w,NULL) ; /* Gadgets zeichnen #/ 

430 

431 ende = F£4_SE; 

432 

433 for(;;) /* Endlosschlei+e %/ 

434 i 

435 i-f (message = (struct IntuiMessage *)GetMsg(w->UserPort)) 

436 t /% Message empfangen und verarbeiten %/ 

437 MessageClass = message->Class; /* Message retten */ 

438 code = message->Code; 

439 ReplyMsg(message); /* Message beantworten */ 

440 switch (MessageClass) 

441 { 

442 case GADGETUP : 

443 case GADGETDOWN : do_gadgets(message, w); 

444 break; /* Wenn Gadget betaetigt, dann...#/ 

445 case MGUSEBUTTQNS: break; 

446 } 

447 > 

448 if (ende = TRUE) 


/* Zeiger auf SuperBitMap #/ 
/# Min. Breite */ 

/# Min. Hoehe */ 

/# Max. Breite #/ 

/# Max. Hoehe */ 

/* Screen-Typ */ 
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449 

450 

451 

452 

453 

454 

455 

456 

457 

458 

459 

460 

461 

462 

463 

464 

465 

466 

467 

468 

469 

470 

471 

472 

473 

474 

475 

476 

477 

478 

479 

480 

481 

482 

483 

484 

485 

486 

487 

488 

489 

490 

491 

492 

493 


< 

close_things(); 
exit(); 

>; 

) 

> 


do_gadgets (mes, win) /% Gadgets ausfuehren %/ 

struct IntuiMessage *mes; 
struct Window *win; 

< 

struct Gadget *igad; 
int gadgid; 

ULONG val; 


lgad = (struct Gadget #) mes->IAddress; /% Ptr auf ein Gadget 

gadgid = igad->GadgetID; /* Eigene Identitaetsnummer */ 
val = (ULONG)TexString.LongInt; 
switch(gadgid) 

{ /% Farben aendem #/ 

case 0: SetRGB4(&screen->ViewPort,0 f r_prop.HörizPot/4096, 
g_prop.HörizPot/4096,b_prop.HörizPot/4096); 

break; 

case 1: SetRGB4(&screen->ViewPort,0,r_prop.HonzPot/4096, 
g_prop.HorizPot/4096,b_prop.HörizPot/4096); 

break; 

case 2: SetRGB4(&screen->ViewPort,0,r_prop.HonzPot/4096, 
g_prop. Hon zPot/4096, b_prop. Hon zPot/4096); 

break; 
case 3: break; 
case 5: ende = TRUE; 
break; 

case 6: DisplayBeep(NLLL); 
break; 

>; 


close_things() /* Unterfunktion zum Schliessen %/ 

{ 

CloseWindow(w); 

CloseLibrary(GfxBase); 

CloseLibrary(IntuitionBase); 


/* Libs und Window schliessen */ 
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System-Meldungen 


System-Meldungen werden dazu benutzt, dem Anwender wichtige Infor¬ 
mationen z.B. über das Amiga-System zu vermitteln oder um Entscheidun¬ 
gen vom Anwender zu verlangen. Hierbei finden zwei verschiedene Typen 
von Systemmeldungen Verwendung: 

Dies ist zunächst einmal die Verwendung von Alerts (englisch Alarm). Dies 
sind rot-blinkende Warnmeldungen des Systems, die immer in einer ho¬ 
rizontalen Auflösung von 640 Pixels dargestellt werden.Wenn ein Alert nur 
einen Teil des Bildschirms nach unten schiebt, so ist es durchaus möglich, 
daß man in das Programm zurückkehrt. Ist der ganze Bildschirm schwarz 
gefärbt, und an der obersten Stelle blinkt das Alert, so bedeutet dies den 
totalen Systemabsturz und das erneute Einlegen der Workbench-Disk. 

Eine weitere Möglichkeit stellen die System-Requester dar. Sie tauchen nur 
dann auf, wenn Entscheidungen oder weitere Informationen vom Benutzer 
verlangt werden. Sie bestehen aus einem Window, in dem sich verschiedene 
Gadgets befinden. 
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9.1 Die Alerts 

Wie in Kapitel 9 schon erwähnt, sind Alerts rot-blinkende »Hilferufe« des 
Systems in einer Auflösung von 640 Pixels auf einem schwarzem Hinter¬ 
grund. Diese Hilferufe können dann durch Betätigen einer Maustaste quit¬ 
tiert werden. 

Je nachdem, ob es ein »DeadEnd-Alert« oder ein »Recovery-Alert« ist, 
gelangt man zurück zum Programm oder auch nicht! 

»DeadEnd-Alerts« 

DeadEnd-Alerts (englisch Sackgasse) signalisieren den kompletten 
Systemabsturz. Sie sind daran zu erkennen, daß nur das jeweilige Alert auf 
dem schwarzen Bildschirm blinkt. Hier können Sie unternehmen, was Sie 
wollen, wenn Sie eine Maustaste betätigen, bedeutet dies immer den Neu¬ 
start mit der Workbench! 

»Recovery-Alerts« 

Diese Art von Alerts, die sogenannten rückkehrfähigen Alerts, teilen dem 
Benutzer mit, daß er knapp an einem Systemabsturz vorbeigekommen ist. 
Erkennbar sind diese Alerts daran, daß der augenblickliche Bildschirm nach 
unten geschoben wird und ein roter Kasten auf schwarzem Hintergrund am 
oberen Teil des Bildschirms blinkt. Drücken Sie nun eine Maustaste, so wird 
das System nicht zurückgesetzt. Wenn jedoch das Amiga-System 
anschließend nicht mehr mit der Arbeit fortfahren kann, kann es durchaus 
Vorkommen, daß es »vergißt« nach dem Anzeigen des Alerts in das Pro¬ 
gramm zurückzukehren und das System trotzdem zurücksetzt. 

Beim Aufrufen von Alerts besteht einmal die Möglichkeit vorbereitete Alerts 
von »Exec« oder selbst-defmierte Alerts von »Intuition« aus aufzurufen. Sehr 
reizvoll sind hier die selbst-definierten Alerts, da der Programmierer über sie 
wichtige Informationen bzw. Meldungen sehr einfach und wirkungsvoll dem 
Programm-Anwender mitteilen kann. 
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9.1.1 Der Aufruf von System-Alerts 

System-Alerts sind vorbereitete Alerts, die einen festen Text besitzen. Für 
das Aufrufen von System-Alerts besitzt das Exec-Library einen bestimmten 
Befehl: 

Alert(AlertNummer, Parameter) 

AlertNummer gibt die Nummer des Alerts an. Eine Übersicht über die vor¬ 
bereiteten Alerts finden Sie im Anhang C. Die Variable »Parameter« kann 
im Normalfall auf 0 gesetzt werden. 
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1 

2 

3 Exec-Alert-Demo 

4 last update 26/05/87 

5 von Joerg Koch und Frank Kremser 

6 (c) Markt & Technik 1987 

7 

8 ****************** Hc***#**##*#*## 

9 

10 Diese Demonstration gibt zwei System-AIerts aus. Der Erste kehrt wieder 

11 zurueck. Der Zweite ist allerdings ein Dead-End-Alert. 

12 

13 *******************************/ 

14 

15 #include <exec/alerts.h> /* Include-Files einiesen */ 

16 #include <exec/types.h> 

17 #include <exec/tasks.h> 

18 #include <exec/libraries.h> 

19 #include <exec/devices.h> 

20 ttinclude <exec/execbase.h> 

21 #include <hardware/blit.h> 

22 #include <devices/keymap.h> 

23 ttinclude <graphics/regians.h> 

24 #include <graphics/copper.h> 

25 #include <graphics/gels.h> 

26 #include <graphics/g-fxbase. h> 

27 #include <graphics/g-fx.h> 

28 #include <graphics/clip.h> 

29 #include <graphics/view.h> 

30 #include <graphics/rastport.h> 

31 #include <graphics/layers.h> 

32 #include <intuition/intuition.h> 

33 

34 

35 struct ExecBase *ExecBase; 

36 

37 

38 main() 

39 { 

40 LGNG warte; 

41 

42 i-f ((ExecBase = (struct ExecBase *) /* Exec-Bibliothek oe-f-fnen */ 

43 0penLibrary("exec.1ibrary", 0)) =0) exit(); 

44 

45 Alert(AN_BitMap,0,0); /* Erster Alert */ 

46 

47 -for(warte = 0; warte < 100000; warte++); /* Abwarten */ 

48 

49 Alert(AT_DeadEnd + AG_NoMemory + AÜ_BootStrap,0,0); /* Zweiter Alert */ 

50 

51 CloseLibrary(ExecBase); 

52 > 


/* Exec-Bibliothek schl i essen */ 
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9.1.2 Der Aufruf von Intuition-Alert 

Intuition-Alerts sind komfortabler als Exec-Alerts, denn bei ihnen kann der 
Programmierer den Text und die Größe selbst bestimmen. Aufgerufen wer¬ 
den Intuition-Alerts mit: 

DisplayAlert(Type, Nachricht, Höhe) 

Die Variable »Type« gibt an, ob nach dem Betätigen der Maustaste mit dem 
Programm fortgefahren werden soll oder ob das System zurückgesetzt wird. 
Ist in Type RECOVERY ALERT eingetragen, so kann nach dem Anzeigen 
des Alerts das Programm fortfahren. Wenn das System zurückgesetzt werden 
soll, muß für Type DEADEND ALERT eingetragen werden. 

»Nachricht« ist der Pointer auf eine Nachricht. Die Nachricht muß wie folgt 
aufgebaut sein: 

Zuerst muß die Position des Textes durch eine 16-Bit x- und eine 8-Bit y- 
Koordinate festgelegt werden. Danach folgt der Text, der mit einer 0 enden 
muß, damit Intuition erkennt, wann der Text zu Ende ist. Der letzte Para¬ 
meter des Texts gibt an, ob ein weiterer Text folgt. Folgt keine weitere Nach¬ 
richt, so muß nach dem Text, der mit einer 0 endet, eine weitere 0 eingetra¬ 
gen werden. Wenn ein weiterer Text folgen soll, so muß der Parameter 
ungleich 0 sein. 

Die Variable »Höhe« gibt an, wie hoch der rot-blinkende Kasten, in dem sich 
die Nachricht befindet, werden soll. 
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1 /*#***#**#**##*#******#*#*#*###* 

2 

3 Alerts-Demonstration 

4 last update 25/05/87 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt & Technik- 1987 

7 

8 ******************************** 

9 

10 Diese Demonstration erzeugt zwei Alerts in Folge. Der erste kehrt 

11 zurueck, der zweite bewirkt einen Neustart. 

12 

13 *******************************/ 

14 

15 #include <exec/types.h> /* Einladen der Include-Files */ 

16 #include <exec/tasks.h> 

17 #include <exec/libraries.h> 

18 #include <exec/devices.h> 

#include <devices/keymap.h> 

#include <hardware/blit.h> 

21 #include <graphics/regions.h> 

22 #include <graphics/copper.h> 

23 #include <graphics/gels.h> 

24 #include <graphics/g-fxbase.h> 

25 #include <graphics/gfx.h> 

26 #include <graphics/clip.h> 

27 #include <graphics/view.h> 

28 #include <graphics/rastport.h> 

29 #include <graphics/layers.h> 

30 #include <intuition/intuition.h> 

31 #include <intuition/intuitionbase.h> 

32 

33 

34 struct IntuitionBase *IntuitionBase; 

35 

36 char alertlC] = /# Text und Parameter fuer das Recovery-Alert */ 

37 i 

"\0\240\30Dies ist ein REC0VERY-Alert\0\l\0\250\60Bitte druecken Sie eine Maustaste\0\C 

>; 

40 

41 char alert2C] = /% Text und Parameter -fuer das Dead-End-Alert */ 

42 { 

43 "\0\240\30Dies ist ein DEADEND-Alert\0\l \0\250\60Bi tte druecken Sie eine Maustaste\0\0‘ 

44 >; 

45 

46 


47 

main<) 




48 

< 




49 

LC3NG warte; /* Variable fuer Warte-Schleife */ 




50 





51 

i-f ((IntuitionBase = (struct IntuitionBase *) 

/* 

Intuition-Library 

*/ 

52 

0penLibrary("intuition.library", 0)) == 0) exit() 

;/* 

oef-fnen 

#/ 

53 





54 

Disp1ayA1er t(REC0VERY_ALERT,&a1er 11C 0],90); 

/* 

Erstes Alert dar- 

*/ 

55 


/* 

stellen 

*/ 

56 

■for(warte = 0; warte < 300000; warte++); 

/* 

und warten 

*/ 

57 





58 

Dlsp1ayA1er t(DEADEND_ALERT,&a1er 12C 0],90); 

/* 

Zweites Alert 

*/ 

59 


/* 

darstellen 

*/ 

60 

CloseLibrary(IntuitionBase); 

/* 

Intuition-Library 

*/ 

61 

> 

/* 

sc hl i essen 

*/ 




Einfache Systemmeldungen durch Requester 237 


9.2 Einfache Systemmeldungen durch 
Requester 

Requester sind menüähnliche Fenster. Sie können Standard-Requester ver¬ 
wenden oder eigene definieren. Sie werden deshalb als Requester bezeichnet, 
weil der Benutzer erst die Nachfrage (Request) des Systems oder des Pro¬ 
gramms beantworten muß, bevor im Programm fortgefahren werden kann. 

Die Nachfrage muß meistens durch das Anklicken eines Gadgets mit der 
Aufschrift »OK« oder »CANCEL« beantwortet werden. »OK« dient 
meistens zum Auslösen einer Funktion, während »CANCEL« die Nachfrage 
abbricht. 

Das Fenster, aus dem das Requester besteht, ist nichts anderes als ein 
Window, somit kann es auch Front-, Schließ-, Back- und Größen-Gadgets 
besitzen. Es besitzt auch eine Titel-Leiste, an der es ergriffen und über den 
Bildschirm bewegt werden kann. 

Dem Programmierer stehen unterschiedliche Methoden zur Verfügung, ein 
Requester erscheinen zu lassen. Die einfachste ist das Bilden eines 
Requesters mittels AutoRequest(), das die Abfrage wahr oder falsch erlaubt. 
Schwieriger sind dagegen die selbst-definierten Requester, die z.B. ein eige¬ 
nes Image oder eigene Gadgets besitzen. Eine besondere Art Requester zu 
verwenden, bietet die Funktion SetDMRequest(). SetDMRequest läßt ein 
Requester erscheinen, wenn der Benutzer die Menü-Maustaste kurz hinter¬ 
einander zweimal betätigt (Double-Klick). 

Wichtig ist, daß jeder Requester zu einem Window gehört, in dem ein Pro¬ 
gramm abläuft. Aus diesem Grund muß auch bei fast jedem Requester-Be- 
fehl ein Zeiger auf die Window-Structure des Windows angegeben werden, 
zu dem der Requester gehören soll. 
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9.3 Die Requester-Structure 

Möchte man von der vorgefertigten Form der Auto-Requester abweichen, so 

muß man eine eigene Requester-Structure anlegen. Diese hat folgende 

Form: 

struct Requester 

{ 

struct Requester »OlderRequest; 

SHORT LeftEdge, TopEdge; 

SHORT Uldth, Height; 

SHORT RelLeft, RelTop; 
struct Gadget »ReqGadget; 
struct Border »ReqBorderj 
struct IntuiText »ReqText; 

USHORT Flags 

UBYTE BackFlll; 

struct Layer »ReqLayer; 

UBYTE ReqPadl[52]; 
struct BltMap »ImageBMap; 
struct Window »RWindow; 

UBYTE ReqPad2[?6]; 

)i 

OlderRequest Zeiger auf den zuletzt behandelten Requester 

(Wird von Intuition belegt). 

LeftEdge, TopEdge Flier muß die Position eingetragen werden, an der 
das Requester erscheinen soll. 

Width, Height Width und Height geben die Größe des Requesters 

an. 

RelLeft, RelTop Diese beiden Variablen geben die relative Position 

des darzustellenden Requesters in Bezug auf die 
augenblickliche Position des Mauszeigers an. Dazu 
muß das POINTREL-Flag bei Flags gesetzt sein. 

ReqGadget Hier muß der Zeiger auf das erste Gadget in der 

Gadgetliste eingetragen werden. Mindestens eines 
Gadgets muß das ENDGADGET-Flag gesetzt ha¬ 
ben, damit das Requester anschließend wieder 
gelöscht wird. 

ReqBorder Hier muß der Zeiger auf die Border-Struktur ein¬ 

getragen werden, die das Requester umranden soll. 
Wird keine Border verwendet so ist diese Variable 
»NULL«. 
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ReqText 

ReqText gibt den Zeiger auf die Intuition-Text- 
Structure an, die den Text enthält, der in das 
Requester geschrieben werden soll. Sollen mehrere 
Texte verwendet werden, so muß in der IntuiText- 
Structure jeweils ein Zeiger auf den nächsten Text 
angegeben werden. 

Flags 

Durch das Setzen von verschiedenen Flags kann 
das Verhalten und Aussehen von Requestern 
bestimmt werden: 


POINTREL 

Dies Flag gibt an, daß 
das Requester beim 
Initialisieren relativ zur 
augenblicklichen Maus¬ 
zeiger-Position darge¬ 
stellt werden soll. Bei 
der alten Workbench- 
version hat dieses Flag 
keine Bedeutung. 


PR ED RA WN 

Wenn eigene BitMaps 
verwendet werden sol¬ 
len, muß dieses Flag 
gesetzt werden. 


Diese Flags werden von 

Intuition gesetzt: 


REQOFFWINDOW 

Dieses Flag ist gesetzt, 
wenn das Requester 
aktiv, aber das Window 
des Requesters nicht 
aktiv ist. 


REQACTIVE 

Dieses Flag gibt an, ob 
das Requester augen¬ 
blicklich benutzt oder 
nicht benutzt wird. 


SYSREQUEST 

Dieses Flag wird gesetzt, 
wenn das Requester ein 
System-Requester ist. 

BackFill 

Hier wird die Farbe eingetragen, mit der der Hin¬ 
tergrund des Requesters ausgefüllt werden soll. 

ReqLayer 

Enthält die Adresse der »Grafik-Schicht«, die das 
Requester verdeckt. 



240 System-Meldungen 


ReqPadl[32] 

ImageBMap 


RWindow 

ReqPad2[36] 


Ist für die interne Benutzung reserviert. 

Wenn ein eigenes Bit-Map verwendet werden soll, 
muß hier der Zeiger auf das eigene Bit-Map ein¬ 
getragen werden. Zudem muß noch in Flags das 
Flag PREDRAWN gesetzt sein. Soll kein eigenes 
Bit-Map verwendet werden, so muß hier »NULL« 
eingetragen werden. 

Dies ist eine System-Variable. 

Ist für die interne Benutzung reserviert. 
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9.4 Selbstdefinierte Requester 

Selbstdefinierte Requester sind Requester, die von Grund auf vom Pro¬ 
grammierer selbst definiert werden. Im Vergleich zu AutoRequest() muß bei 
selbstdefinierten Requestern alles selbst in die Hand genommen werden. 
Zunächst muß eine Structure, die Requester-Structure, die wir im vorher¬ 
gehenden Kapitel beschrieben haben, definiert werden. In dieser Structure 
braucht nur das Nötigste angegeben zu werden, da die Funktion 
InitRequestQ alles Übrige erledigt, um eine ordentliche Requester-Structure 
zu definieren. 

Durch anschließendes Aufrufen der Funktion RequestQ oder 
SetDMRequest wird Ihr Requester in dem jeweiligen Window dargestellt. 
Damit das Requester wieder gelöscht werden kann, muß eines der selbst¬ 
definierten Gadgets das Flag ENDGADGET in der Variable »Activate« 
gesetzt haben, damit das Requester bei Betätigung dieses Gadgets vom Bild¬ 
schirm verschwindet. 

SetDMRequest hat fast dieselbe Funktion wie Request(). Der Unterschied 
liegt darin, daß SetDMRequest ein Double-Menü-Requester bildet, das nur 
dann sichtbar wird, wenn der Benutzer zweimal die Menütaste - gleich 
rechte Taste - der Maus betätigt. 

Gelöscht werden kann das Requester, neben dem Setzen des Flags 
ENDGADGET, zusätzlich durch das Anwenden der Befehle EndRequest() 
und ClearDMRequest. 
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9.5 Das Auto/System-Request 

Falls nur eine simple »JA« oder »NEIN«-Antwort und auch kein eigenes 
BitMap sowie Gadgets benötigt werden, reicht die Darstellung von 
Requesters durch die Intuition-Funktion AutoRequest() vollkommen aus. 
Wenn diese Funktion aufgerufen wird, bildet Intuition das Requester, stellt 
es mit dem gewünschten Text dar und wartet auf eine Antwort des 
Benutzers. 

Der Text, der dargestellt werden soll, wird mit AutoRequest() übergeben. 
Dabei ist zu beachten, daß sich die positive Nachricht immer in der linken 
Ecke und die negative Nachricht in der rechten Ecke des Requsters befindet. 
Der positive Text kann auch auf »NULL« gesetzt werden, wenn dem 
Benutzer keine Auswahlmöglichkeit zwischen »Wahr« und »Falsch« gegeben 
werden soll, was jedoch relativ selten vorkommt. 

Zu jedem der zwei Auswahlmöglichkeiten können IDCMP-Flags gesetzt 
werden. Dies sind bestimmte Flags,die die Kommunikation zwischen dem 
Anwender und dem System regeln. Wenn keine weiteren speziellen Flags 
benötigt werden, kann PosFlags, bzw. NegFlags gleich »NULL« gesetzt 
werden. Ansonsten können folgende Flags verwendet werden: 

REQSET Wenn dieses Flag gesetzt ist, erhalten Sie eine 

Nachricht, wenn das Requester geöffnet ist. 

REQCLEAR Wenn das letzte Requester aus der zugehörigen 

Window-Structure gelöscht und dieses Flag gesetzt 
ist, erhalten Sie eine Nachricht. 

REQVERIFY Dieses Flag kann gesetzt werden, um sicher zu 

gehen, daß andere wichtige Entscheidungen zuerst 
getroffen werden, bevor das Requester dargestellt 
wird. 

AutoRequest() gibt »TRUE« zurück, falls das positive Gadget betätigt wurde 
und »FALSE« für das negative Gadget. 

Die AutoRequest()-Funktion ruft die Funktion BuildSysRequestQ auf. 
Durch sie wird das Requester dargestellt. Die Gadgets, die durch 
BuildSysRequest() definiert werden, haben folgende Flags in ihrer Structure 
gesetzt: 

BOOLGADGET für eine Abfrage ob »Wahr« oder »Falsch«, 

RELVERIFY um sicherzugehen, daß der Anwender das Gadget auch wirk¬ 
lich angeklickt hat, 
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REQUGADGET um zu überprüfen, ob es sich um ein Requester-Gadget 
handelt, 

TOGGLESELECT-Flag, das besagt, daß der Zustand des Gadgets durch 
Anklicken verändert wird. 

Für den Programmierer haben diese Flags in diesem Fall keine Bedeutung, 
da sie von Intuition selbst kontrolliert werden. 
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9.6 Die Requester-Befehle 

9.6.1 AutoRequest 

Syntax: bool = AutoRequest(Window, TitelText, PosText, NegText, 

PosFlag, NegFlag, Breite, Höhe); 

Funktion: AutoRequest bildet durch Aufrufen der Funktion 

BuilSysRequest einen Requester mit dem angegebenem 
positiven und negativen Text. Danach wartet es so lange, bis 
der jeweilige Text bestätigt wurde und gibt den Wert 
»TRUE« für Bestätigung des positiven Textes und »FALSE« 
für den negativen Text zurück. 

Parameter: Window -> Zeiger auf die Window-Structure des 

Windows, zu dem der Requester gehö¬ 
ren soll 

TitelText -> Zeiger auf eine IntuiText - Structure. 

Dieser Text wird dann in die Titelleiste 
des Requesters geschrieben. 

PosText -> Zeiger auf die IntuiText-Structure des 

NegText positiven und negativen Tex¬ 
tes. 

PosFlag -> geben die Flags für die Gadgets der 

NegFlagpositiven und negativen Nach¬ 
richt an. Hier kann »NULL« eingetra¬ 
gen werden, da AutoRequest das 
Setzen der richtigen Flags selbstständig 
erledigt. 

Breite,Höhe -> Dimension des Requesters. 

Ergebnis: bool -> ist bool gleich »TRUE«, so wurde die 

positive Nachricht gewählt, bei 
»FALSE« die negative. 

Datentyp: struct Window ‘Window; 

struct IntuiText ‘TitelText, ‘PosText, ‘NegText; 

WORD PosFlag, NegFlag; 
int Breite, Höhe; 
bool bool; 
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Sonstiges: 

Wird für die Window-Structure »NULL« gesetzt, so öffnet 
Intuition selbst ein Window. 

Referenz: 

Siehe auch BuildSysRequest 

9.6.2 BuildSysRequest 

Syntax: 

adr = BuildSysRequest(Window, TitelText, PosText, 
NegText, Flags, Weite, Höhe); 

Funktion: 

BuildRequest bildet ein Requester mit dem angegebenem 
positiven und negativen Text. 

Parameter: 

Window -> Zeiger auf die Window-Structure des 

Windows, dem der Requester zuge¬ 
ordnet werden soll 

TitelText -> Zeiger auf eine IntuiText-Structure. 

Dieser Text wird dann in die Titelleiste 
des Requesters geschrieben. 

PosText -> Zeiger auf die IntuiText-Structure des 

positiven Textes 

NegText -> Zeiger auf die IntuiText-Structure des 

negativen Textes 

Flags -> IDCMPFlags der Window 

Breite, Höhe -> Dimension des Requesters. 

Ergebnis: 

adr -> Zeiger auf die Window-Structure des 

Requesters. 

Datentyp: 

struct Window ‘Window; 

struct IntuiText TitelText, ‘PosText, ‘NegText; 

WORD Flags; 
int Breite, Höhe; 

ULONG adr; 

Sonstiges: 

BuildSysRequest() inititalisiert die IDCMP-Flags des 
Window, so daß der UserPort oder WindowPort nur mit 
Wait() abgefragt werden muß, ob die Flags übereinstimmen. 

Ist Window gleich »NULL«, so bildet Intuition selbst ein 
Window. 

Referenz: 

Siehe auch AutoRequest 
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9.6.3 

ClearDMRequest 


Syntax: 

fertig = ClearDMRequest(Window); 


Funktion: 

Löscht das jeweilige Double-Menü-Requester aus der 
Requester-Liste des angegebenen Windows. 


Parameter: 

Window -> Zeiger auf die Window-Structure des 

Windows, in dessen Requester-Liste 
sich das Double-Menü-Requester 
befindet. 


Ergebnis: 

fertig -> TRUE, wenn es gelöscht werden 

konnte, sonst FALSE. 


Datentyp: 

struct Window *Window; 
bool fertig; 


Sonstiges: 

Gesetzt wird das DM-Requester mit SetDMRequest. 


Referenz: 

Siehe auch SetDMRequest 

9.6.4 

EndRequest 


Syntax: 

EndRequest(Requester, Window); 


Funktion: 

Löscht das spezifizierte Requester aus der Requester-Liste 
des angegebenen Windows. 


Parameter: 

Requester -> Zeiger auf die Rcquester-Structure des 

Requesters, das gelöscht werden soll. 



Window -> Zeiger auf die Window-Structure des 

Windows, in dessen Requester-Liste 
sich der Requester befindet. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Requester *Requester; 
struct Window *Window; 


Sonstiges: 

Ein Requester kann mit Request() gesetzt werden. 


Referenz: 

Siehe auch Request 

9.6.5 

FreeSysRequest 


Syntax: 

FreeSysRequest (Window); 


Funktion: 

Löscht alle Requester aus der Requester-Liste des angegebe¬ 
nen Windows, die mit BuildSysRequest erstellt wurden. 
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Parameter: 

Window -> Zeiger auf die Window-Structure des 

Windows, in dessen Requester-Liste 
sich die Requester befinden 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Window *Window; 


Sonstiges: 

Ein solcher Requester kann mit BuildSysRequest() gesetzt 
werden. 


Referenz: 

Siehe auch BuildSysRequest 

9.6.6 

InitRequest 


Syntax: 

InitRequest(Requester); 


Funktion: 

Initialisiert eine Requester-Structure. 


Parameter: 

Requester -> Zeiger auf die zu initialisierende 

Requester-Structure. 


Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Requester *Requester; 


Sonstiges: 

Bevor ein Requester initialisiert werden kann, muß die dazu¬ 
gehörige Gadget-Structure erstellt sein. Diese Funktion 
bringt das Requester nicht auf den Screen, dafür ist 
Request() vorgesehen. 


Referenz: 

Siehe auch Request 

9.6.7 

Request 



Syntax: 

bool = Request(Requester, Window); 


Funktion: 

Stellt das spezifizierte Requester auf dem Screen dar. 


Parameter: 

Requester -> Zeiger auf die Requester-Structure des 

Requesters, der dargestellt werden soll. 

Window -> Zeiger auf die Window-Structure des 

Windows, zu dessen Requester-Liste 
das Requester gehören soll. 


Ergebnis: 

bool -> ist »TRUE«, falls der Requester dar¬ 

gestellt werden konnte und »FALSE«, 
wenn nicht. 
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Datentyp: 

struct Requester *Requester; 
struct Window *Window; 
bool bool; 

Sonstiges: 

Bevor man das Requester mit Request() darstellen kann, 
muß es zuvor mit InitRequest initialisiert worden sein. 


Diese Routine ignoriert das REQVERIFY Flag in der 
Window-Structure. 

Referenz: 

Siehe auch InitRequest 

9.6.8 SetDMRequest 

Syntax: 

bool = SetDMRequest(Window, DMRequester); 

Funktion: 

Stellt das spezifizierte Requester als Double-Menü-Requester 
auf dem Screen dar. 

Parameter: 

Requester - > Zeiger auf die Requester-Structure des 

Requesters, der dargestellt werden soll. 


Window -> Zeiger auf die Window-Structure des 

Windows, zu dessen Requester-Liste 
das Requester gehören soll. 

Ergebnis: 

bool -> falls nicht schon ein DM-Requester 

installiert ist, wird das neue Requester 
installiert und »TRUE« zurück¬ 
gegeben, andernfalls »FALSE«. 

Datentyp: 

struct Requester *Requester; 
struct Window *Window; 
bool bool; 

Sonstiges: 

DMRequester sind besondere Requester, die auf einen 
Double-Klick des Menü-Knopfes der Maus hin erscheinen. 

Referenz: 

Siehe auch ClearDMRequest 
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1 

•y 

/******************************* 


3 

Auto-Requester-Demonstratlon 


4 

last update 26/05/87 


5 

von Joerg Koch und Frank Kremser 


6 

7 

(c) fiarkt & Technik 1987 


/ 

8 

9 

******************************** 


10 

Diese Demonstration erzeugt ein einfaches Requester durch die Funktion 

11 

AutoRequest 


12 

13 

*******************************/ 


14 

15 

#include <exec/types.h> 

/* Include-Files ein laden */ 

16 

»inelüde <exec/nodes.h> 


17 

ttinclude <exec/lists.h> 


18 

ttinclude <exec/ports.h> 


19 

ttinclude <exec/devices.h> 


20 

ttinclude <devices/keymap.h> 


21 

ttinclude <graphics/regions.h> 


22 

ttinclude <graphics/copper.h> 


23 

ttinclude <graphics/gels.h> 


24 

ttinclude <graphics/gfxbase.h> 


25 

ttinclude <graphics/g-fx.h> 


26 

ttinclude <graphics/c 1 ip.h> 


27 

ttinclude <graphics/view.h> 


28 

ttinclude <graphics/rastport.h> 


29 

ttinclude <graphics/layers.h> 


30 

ttinclude <intuition/intuition.h> 


31 

ttinclude <hardware/blit.h> 


32 

33 

struct IntuitionBase #IntuitionBase; 

/* Lib-Zeiger #/ 

54 

struct G-fxBase #GfxBase; 


35 

36 

struct IntuiText text = 

/* Text -fuer das Requester %/ 

37 

( 

/% erstellen #/ 

38 

0 , 

/* DetailPen #/ 

39 

1 . 

/* BlockPen */ 

40 

JAM1, 

/* Drawmode #/ 

41 

17, 

/% X-Wert relativ */ 

42 

20 , 

/* Y-Wert relativ */ 

43 

NULL, 

/* spez. Zeichensatz */ 

44 

"Soll das Programm beendet werden?", 

/* Text */ 

45 

NULL 

/* naechster Text */ 

46 

>; 


47 

48 

struct IntuiText postext = 

/* Text -fuer das positive */ 

49 

{ 

/* Gadget */ 

50 

o, 


51 

1 , 


52 

JW2, 


53 

7, 


54 

4, 


55 

NULL, 


56 

Ja 1 1 , 


57 

NULL 


58 

>; 


59 

60 

struct IntuiText negtext = 

/% Text -fuer das negative */ 

61 


/* Gadget */ 

62 

0 , 


63 

1 , 


64 

JAM2, 
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65 7, 

66 4, 

67 NULL, 

68 "Nein!", 

69 NULL 

70 >; 

71 

72 

73 mainO 

74 < 

75 BOGL ergebnis; 

76 /* Graphik-Bibliothek oe-ffnen */ 

77 if( ! (G-fxBase = (struct G-fxBase *)OpenLibrary("graphics.library",0))> 

78 exitO; 

79 /* Intuition-Bibliothek oef-fnen */ 

80 if(!(IntuitionBase = (struct IntuitionBase %) 

81 OpenLibrary< "mtui tion. 1 ibrary" ,0))) 

82 exitO; 

83 

84 for(;;) /* Endlosschlei-fe #/ 

85 i 

86 ergebnis = AutoRequest(NLU_,&text,&postext,&negtext, 


87 

NULL,NULL,320,70); 

/* Requester darstellen */ 

88 

i-f (ergebnis — TRUE) 

/* Wenn das positive */ 

89 

( 

/% Gadget betaetigt */ 

90 

CloseL ibrary (G-fxBase); 

/* wurde -> abbrechen */ 

91 

CloseLibrary(IntuitionBase); 

/* Libs schliessen %/ 

92 

exit(); 


93 

>; 


94 

>i 


95 > 




1 /%%%%%%%%%%%%********************** 


3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 


Doub1e-Menu-Reques ter-Demons tra tion 
last update 26/05/87 
von Joerg Koch und Frank Kremser 
(c) Markt & Technik 1987 
********************$************** 

Diese Demonstration erzeugt einen Doub1e-Menu-Requester, der erst durch 
zweimaliges Betaetigen der rechten Maustaste sichtbar wird. 

****************************♦****#/ 


#include 

#include 

#include 

#include 

ttinclude 

»include 

ttinclude 

#include 

#include 

♦tinclude 

#include 

♦♦include 

#include 

#include 

4include 

ttinclude 

#include 


<exec/types.h> 
<exec/nodes.h> 

<exec/lists.h> 
<exec/ports.h> 

<exec/devices.h> 
<devices/keymap.h> 
<graphics/regions.h> 
<graphics/copper.h> 
<graphics/gels.h> 
<graphics/g-f xbase. h> 
<graphics/g-f x. h> 
<graphics/c 1 ip.h> 
<graphics/view.h> 
<graphics/rastport.h> 
<graphics/layers.h> 
<intuition/intuition.h> 
< hardware/b 1 it.h> 


/% Include-Files einiesen */ 


Die Requester-Befehle 251 


31 




32 

struct IntuitionBase »IntuitionBase; 


33 

struct GfxBase »GfxBase; 



34 

struct Window *w; 



35 




36 

struct IntuiText postext = 

/» 

Text fuer das positive Gadget */ 

37 

i 

/* 

erstellen %/ 

38 

lt 

/* 

DetailPen */ 

39 

3, 

/* 

BlockPen %/ 

40 

JAM2, 

/* 

Drawmode */ 

41 

7, 

/* 

Linke Ecke */ 

42 

2, 

/* 

Obere Ecke */ 

43 

NULL, 

/* 

System-Zeichensatz */ 

44 

" OK ", 

/* 

Text #/ 

45 

NULL 

/* 

Zeiger au-f naechsten Text %/ 

46 

>; 



47 




48 

SHORT PairsC] = 

/* 

Koordinatenpaare fuer eine */ 

49 

< 

/* 

Border definieren %/ 

50 

0, 0, 



51 

51, 0, 



52 

51, 12, 



53 

0, 12, 



54 

0, 0 



55 

>; 



56 




57 

struct Border buttborder = 

/* 

Border-Structure fuer Rand #/ 

58 

< 

/* 

um Gadget %/ 

59 

-1, 

/% 

Linke Ecke relativ #/ 

60 

-1, 

/% 

Obere Ecke relativ %/ 

61 

2, 

/% 

DetailPen %/ 

62 

0, 

/* 

BlockPen */ 

63 

JAM1, 

/* 

Drawmode #/ 

64 

’ 5, 

/* 

Anzahl der Koordinaten-Paare #/ 

65 

(SHORT *) Pairs ,, 

/* 

Zeiger auf die Koordinaten */ 

66 

NULL 

/* 

Zeiger auf die naechste Border %/ 

67 

>; 



68 




69 

struct Gadget gad = 

/* 

Gadget erste1 len #/ 

70 

< 



71 

NULL, 

/* 

Naechstes Gadget #/ 

72 

30, 

/* 

Linke Ecke */ 

73 

46, 

/* 

Obere Ecke #/ 

74 

50, 

/# 

Breite %/ 

75 

11, 

/* 

Hoehe */ 

76 

GADGHCQMP, 

/* 

Flags #/ 

77 

RELVERIFY!GADGIMMEDIATE 1ENDGADGET, 

i /# Activation #/ 

78 

BOOLGADGET!REQGADGET, 

/* 

Gadget-Typ %/ 

79 

(APTR)&bu t t_border, 

/% 

GadgetRender - Border */ 

80 

NULL, 

/% 

Selec tRender - Border %/ 

81 

&postext, 

/* 

Gadget-Text */ 

82 

o, 

/* 

MutualExclude #/ 

83 

o, 

/* 

Special Info */ 

84 

o, 

/* 

Gadget-Identitaet %/ 

85 

0 

/* 

User-Daten */ 

86 

>; 



87 




88 

struct IntuiText text = 



89 

{ 



90 

1. 



91 

3, 



92 

JAM2, 



93 

13, 



94 

5, 
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95 

0, 


96 

"Requester", 


97 

0 


98 

>; 


99 



100 

SHORT ReqPairsC 1 = 


101 

< 


102 

5, 3, 


103 

95, 3, 


104 

95, 78, 


105 

5, 78, 


106 

5, 3, 


107 

>; 


108 



109 

struct Border out border = 


110 

( 


111 

-i, 


112 

-i, 


113 

2, 


114 

0, 


115 

JW1, 


116 

5, 


117 

(SHORT *) ReqPairs, 


118 

NULL 


119 

>; 


120 



121 

struct Requester request = 

/% Requester erstellen */ 

122 

{ 


123 

NULL, 

/* Older Requester */ 

124 

50, 

/% Linke Ecke */ 

125 

50, 

/# Obere Ecke #/ 

126 

100, 

/# Breite */ 

127 

80, 

/* Hoehe */ 

128 

0, 

/* RelLe-f t */ 

129 

o, 

/# RelTop #/ 

130 

&gad, 

/* Requester—Gadget #/ 

131 

&out_border, 

/* Requester—Border */ 

132 

&text, 

/# Requester-Text #/ 

133 

NULL, 

/* Flags */ 

134 

3, 

/# Hintergrund-farbe %/ 

135 

NULL, 

/% Layer */ 

136 

NULL, 

/* nur -fuer das System */ 

137 

NULL, 

/* Zeiger au-f eigenes Requester-Image */ 

138 

NULL, 

/* nur -fuer das System #/ 

139 

NULL 

/% nur fuer das System %/ 

140 

>; 


141 



142 

struct NewWindow nw = 

/% Window erstellen */ 

143 

< 


144 

o, 

/* Linke Ecke */ 

145 

0, 

/% Obere Ecke %/ 

146 

640, 

/% Breite */ 

147 

256, 

/* Hoehe */ 

148 

0, 

/* DetailPen */ 

149 

1, 

/% BlockPen */ 

150 

REQCLEAR, 

/% IDCT'FFlags */ 

151 

ACTIVATE!WINDQWDEPTH!WINDOWDRAG, /* Flags */ 

152 

NULL, 

/* Zeiger au-f das erste Gadget %/ 

153 

NULL, 

/% Checkmark #/ 

154 

NULL, 

/% Window-Titel #/ 

155 

NULL, 

/% Zeiger au-f den Screen %/ 

156 

NULL, 

/% Zeiger au-f SuperBitNap */ 

157 

0, 

Minimale Breite %/ 

158 

0, 

/* Minimale Hoehe */ 
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159 

160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 

193 

194 

195 

196 

197 

198 

199 

200 
201 
202 

203 

204 

205 

206 


0 , 

0 , 

WBENCHSCREEN 

>; 


/* Maximale Breite */ 
/* Maximale Hoehe */ 
/% Screen-Typ %/ 


main<) 
i 

struct IntuiMessage *message; 

ULONG MessageClass; 

USHORT code; 

/* Grafik-Bibliothek oe-f-fnen */ 
G-fxBase = (struct G-fxBase # )OpenLibrary( "graphics. library" ,0); 
i-f( G-fxBase = NULL) exit(); 

/* Intuition-Bibliothek oe-f-fnen */ 
IntuitionBase = (struct IntuitionBase *) 

0penLibrary( "mtuition. library" ,0); 
if(IntuitionBase = NULL) exit(); 


w = (struct Window #)0penWindow(&nw); /% Window oe-f-fnen #/ 

i-f(w = NULL) exitO; 


SetDMRequest(w,&request); /% Dieser Be-fehl setzt ein Double-Menu- 

Requester, das aktiviert werden muss, 
indem zweimal die rechte Maustaste 
betaetigt wird. 

Soll ein normaler Requester verwendet 
werden, so muss an dieser Stelle 
■folgender Befehl eingesetzt werden: 


for (; 
i-f 


) 


Request(&request,w); */ 

/# Endlosschleife %/ 


(message = (struct IntuiMessage *)GetMsg(w->UserPort)) 

{ /% Meldungen vom Port holen, #/ 

MessageClass = message->Class; /* Message retten %/ 
code = message->Code; 

ReplyMsg(message); /# beantworten */ 


lf(MessageClass == REÜCLEAR) 

CloseWindow(w); 

CloseLibrary(GfxBase); 
CloseLibrary(IntuitionBase); 
exit(); 

>; 

>; 


/# und auswerten #/ 

/* Wenn kein Requester mehr #/ 
/* vorhanden ist, soll dass #/ 
/% Programm beendet werden %/ 
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10 


Die Ein- und Ausgabe 


Die Ein-/Ausgabe mittels DOS-Befehlen ist äußerst einfach zu handhaben, 
wie aus den Demonstrationsprogrammen ersichtlich ist. 

Aber auch über die sogenannten Devices läßt sich die Ein- und Ausgabe 
steuern, womit der Programmierer erheblich größere Freiheiten hat, als bei 
den DOS-Befehlen, die ihn doch etwas einschränken. 
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10.1 DOS-Funktionen in Programmen 

Auch von Programmen aus kann überaus leicht auf Daten zugegriffen werden, 
die sich auf Diskette befinden. Die nachfolgenden Befehle zeigen dies. Diese 
Befehle lassen sich aber nicht nur auf Disketten-Daten anwenden, sondern 
ermöglichen auch die Kommunikation mit anderen Geräten, wie zum Beispiel 
mit dem Drucker oder Modem, da die Ein- und Ausgabe leicht umgeleitet 
werden kann. Dies geschieht wie folgt: 

datei = Open("PRT:",MODE_NEWFILE); 

Anschließend können Daten mit dem Write-Befehl auf dem Drucker ausgegeben 
werden. 

Überaus leicht können auch Daten in System-Windows unter Intuition aus¬ 
gegeben werden, was allerdings für normale Anwendungen nicht sehr inter¬ 
essant sein dürfte. Sollte Sie dieses Thema interessieren, sehen Sie unter dem 
DOS-Befehl Execute nach. 

Eine Anwendung, die wir an dieser Stelle schon beschreiben möchten, kann für 
Sie als Programmierer von sehr großer Bedeutung sein: Das Laden von 
Bilddateien in einen bestehenden Screen. 

Zuerst muß ein normaler Screen geöffnet werden, wie es in Kapitel 2 be¬ 
schrieben ist. Wenn der Screen das Format 320 x 256 Pixel hat, berechnet sich 
die Länge einer Bitplane wie folgt: 

planelänge = 320 * 256 / 8; 

Nehmen wir an, daß der geöffnete Screen fünf Bitplanes besitzt, so müssen 
diese fünf Bitplanes auch einzeln eingeladen werden. Im Programm sieht das 
Ganze dann folgendermaßen aus: 

struct FileHandle *datei; 


main () 

{ 

LONG länge; 

LONG erstesbyte; 


planelänge = 320 * 256 / 8; 
datei = Open("bild",MODE_OLDFILE); 
if (datei != 0) 
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länge = Read (datei, erstesbyte, planelänge) ;/*ar>fl bis 5 sind */ 
länge = Read(datei,erstesbyte,planelänge);/*die Adressen der*/ 
länge = Read(datei,erstesbyte,planelänge);/*Bit-Plane-Puffer*/ 
länge = Read(datei,erstesbyte,planelänge); 
länge = Read(datei,erstesbyte,planelänge); 

Close(datei); 


) 

ScreenPtr muß dabei der Zeiger auf die Screen-Structure sein, die von 
OpenScreen zurückgegeben wird. 


10.1.1 Close 


Syntax: 

Close(datei); 

Funktion: 

Schließt eine geöffnete Datei. 

Parameter: 

datei -> Zeiger auf die FileHandle-Structure der 

Datei, die zuvor mit Open geöffnet 
worden sein muß. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct FileHandle * datei; 

Sonstiges: 

Jede Datei, die zuvor mit Open geöffnet worden ist, muß, wenn 
sie nicht mehr benötigt wird, wieder geschlossen werden, da 
sonst ein IO-Fehler auftreten kann. 

Zudem sollten Sie in Ihren Programmen nie Dateien schließen, 
die an anderer Stelle geöffnet worden sind. 

Referenz: 

Siehe auch Open 

CreateDir 

Syntax: 

lock = CreateDir(name); 

Funktion: 

Erzeugt ein neues Datei verzeichnis auf der Diskette. 

Parameter: 

name -> Name des neuen Datei-Unterverzeich¬ 

nisses. 

Ergebnis: 

lock -> Zeiger auf die Lock-Structure des Datei- 

Unterverzeichnisses. 

Datentyp: 

char nameO; 
struct Lock *lock; 
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Sonstiges: In einer Lock-Structure sind alle wichtigen Informationen über 

eine bestimmte Datei bzw. über ein bestimmtes Datei- 
Verzeichnis enthalten, die DOS benötigt, um damit arbeiten zu 
können. 

Referenz: Siehe auch CLI-Befehl makedir und DeleteFile 

10.1.3 CurrentDir 

Syntax: altlock = CurrentDir(lock); 

Funktion: Wählt ein neues Datei-Verzeichnis als Arbeitsverzeichnis. 

Parameter: lock -> Zeiger auf die Lock-Structure des Datei- 

Verzeichnisses, das gesetzt werden soll. 

Ergebnis: altlock -> Zeiger auf die Lock-Structure des zuvor 

gesetzten Datei-Verzeichnisses. 

Datentyp: struct Lock *lock, *altlock; 

Sonstiges: Wird 0 zurückgegeben, bedeutet dies, daß das bisherige Ver¬ 

zeichnis das Hauptverzeichnis der Boot-Diskette war. 

Referenz: Siehe auch CLI-Befehl cd und Lock 


10.1.4 DeleteFile 


Syntax: 

erfolg = DeleteFile(name); 

Funküon: 

Löscht die spezifizierte Datei oder das spezifizierte Datei- 
Verzeichnis. 

Parameter: 

name -> Name der zu löschenden Datei bzw. des 

zu löschenden Datei-Verzeichnisses. 

Ergebnis: 

erfolg -> ist ein Wahrheitswert. Er ist TRUE, 

wenn gelöscht werden konnte, ansonsten 
ist er FALSE. 

Datentyp: 

char namef]; 
bool erfolg; 

Sonstiges: 

Ein Datei-Verzeichnis kann nur dann gelöscht werden, wenn es 
keine weiteren Dateien oder Verzeichnisse mehr enthält. 


Referenz: 


Siehe auch CLI-Befehl delete 
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10.1.5 DupLock 

Syntax: 

neulock = DupLock(lock); 

Funktion: 

Erzeugt eine Kopie der angegebenen Lock-Structure. 

Parameter: 

lock -> Zeiger auf zu kopierende Lock-Struc¬ 

ture. 

Ergebnis: 

neulock -> Zeiger auf Kopie der Lock-Structure. 

Datentyp: 

struct Lock *lock, * neulock; 

Sonstiges: 

Dieser Befehl wird verwendet, um mehrere Lock-Structures 
einer Datei bzw. eines Verzeichnisses zu erhalten. 

Benötigt wird dies, wenn auf eine Datei bzw. auf ein Ver¬ 
zeichnis unabhängig voneinander zugegriffen werden soll. 
Möglich ist dies allerdings nur, wenn es eine READ-Lock- 
Structure ist (siehe Lock). Sollte trotzdem versucht werden, eine 
WRITE-Lock-Structure zu kopieren, tritt ein Fehler auf, und 
"neulock" ist gleich 0. 

Referenz: 

Siehe auch Lock 

10.1.6 Examine 

Syntax: 

erfolg = Examine(lock,puffer); 

Funktion: 

Ermittelt den ersten Eintrag eines Verzeichnisses oder Detail- 
Informationen über eine Datei. 

Parameter: 

lock -> Zeiger auf die Lock-Structure der Datei 

bzw. eines Verzeichnisses. 

puffer -> Zeiger auf den Speicherbereich, in den 

der Eintrag bzw. die Informationen ein¬ 
getragen werden sollen. 

Ergebnis: 

erfolg -> TRUE, wenn kein Fehler aufgetreten ist. 

Datentyp: 

struct Lock *lock; 

struct FilelnfoBlock *puffer; 

bool erfolg; 

Sonstiges: 

Wird ein Datei-Verzeichnis abgefragt, enthält der Puffer den 
Namen, die Größe und das Erstellungsdatum des Eintrages. 
Zudem kann ausgelesen werden, ob der Eintrag eine Datei oder 




260 Die Ein- und Ausgabe 



ein Unterverzeichnis ist. Hier gilt: negativer Wert bedeutet 
Datei, positiver Wert Dateiverzeichnis. 

Referenz: 

Siehe auch ExNext 

10.1.7 Execute 

Syntax: 

erfolg = Execute(befehl,eingabe,ausgabe); 

Funktion: 

Führt einen CLI-Befehl aus. 

Parameter: 

befehl -> CLI-Befehl, der ausgeführt werden soll. 

eingabe -> Zeiger auf die FileHandle-Structure der 

Eingabe-Einheit. 

ausgabe -> Zeiger auf die FileHandle-Structure der 

Ausgabe-Einheit. 

Ergebnis: 

erfolg -> ist TRUE, wenn kein Fehler aufgetreten 

ist Ansonsten ist er FALSE. 

Datentyp: 

char befehlt]; 

struct FileHandle *eingabe, *ausgabe; 
bool erfolg; 

Sonstiges: 

»befehl« muß den gesamten CLI-Befehl mit Parametern ent¬ 
halten: 

»rename test,endversion« 

»eingabe« ist im Normalfall gleich 0. 

Für »ausgabe« gleich 0 werden alle Meldungen des CLI-Befehls 
im aktuellen Window ausgegeben. Es kann aber auch eine 
andere Ausgabeeinheit angegeben werden. Diese muß dann 
zuerst mit Open geöffnet werden. Der von Open zurück- 
gegebene Zeiger auf die zugehörige FileHandle-Structure muß 
dann für »ausgabe« angegeben werden. 
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10.1.8 

ExNext 



Syntax: 

erfolg = ExNext(lock,puffer); 


Funktion: 

Ermittelt den Eintrag, der dem mit Examine ermittelten 
Eintrag folgt. 


Parameter: 

lock -> Zeiger auf die Lock-Structure der 

Datei, bzw. eines Verzeichnisses. 



puffer -> Zeiger auf den Speicherbereich, in den 

der Eintrag, bzw. die Informationen 
eingetragen werden sollen. 


Ergebnis: 

erfolg -> TRUE, wenn kein Fehler aufgetreten 

ist. 


Datentyp: 

struct Lock *lock; 

ULONG puffer; 
bool erfolg; 


Sonstiges: 

Sollten keine Einträge mehr vorhanden sein, enthält der 
Puffer den Eintrag ERROR NO MORE ENTRIES. 


Referenz: 

Für nähere Informationen siehe Examine. 

10.1.9 

Info 



Syntax: 

erfolg = Info(lock,info data); 


Funktion: 

Holt Informationen über eine Diskette, Datei oder ein Ver¬ 
zeichnis von der Diskette. 


Parameter: 

lock - > Zeiger auf die Lock-Structure der 

Datei oder des Verzeichnisses, über 
das Informationen geholt werden sol¬ 
len. 



info data -> Zeiger auf eine leere InfoData- 

Structure, in die die Informationen 
geschrieben werden sollen. 


Ergebnis: 

erfolg -> ist TRUE, wenn kein Fehler auftrat. 


Datentyp: 

struct Lock *lock; 

struct Info Data *info_data; 

bool erfolg; 
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Sonstiges: 

Wenn Informationen über eine Diskette ermittelt werden 
sollen, enthält die Info Data-Structure die Speicherkapazität, 
freie Blöcke und eventuelle Disketten-Fehler. 

Referenz: 

Siehe auch CLI-Befehl info 

10.1.10 Input 

Syntax: 

datei = Input(); 

Funktion: 

Ermittelt den Zeiger auf die FileHandle-Structure mit der 
das Programm initialisiert wurde. 

Parameter: 

Keine Parameter. 

Ergebnis: 

datei -> Zeigerauf die FileHandle-Structure. 

Datentyp: 

struct FileHandle * datei; 

Sonstiges: 

Die oberste Eingabeebene ist im Normalfall die Boot-Dis¬ 
kette. 

Referenz: 

Siehe auch Output 

10.1.11 IOErr 

Syntax: 

fehler = IoErrQ; 

Funktion: 

Holt die Fehlernummer des zuletzt aufgetretenen IO-Fehlers. 

Parameter: 

Keine Parameter. 

Ergebnis: 

fehler -> Fehlernummer. 

Datentyp: 

int fehler; 

Sonstiges: 

Der Fehler kann anhand der Fehlernummer und dem 
Anhang D dieses Buches ermittelt werden. 

Referenz: 

Siehe auch Anhang D 

10.1.12 Islnteractive 

Syntax: 

bool = Islnteractive(datei); 

Funktion: 

Dieser Befehl stellt fest, ob die angegebene Datei einem vir¬ 
tuellen Terminal angehört. 

Parameter: 

datei -> Zeiger auf das FileHandle der Datei, 

die überprüft werden soll. 
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Ergebnis: 

bool -> ist TRUE, wenn die Datei einem virtu¬ 

elle Gerät angehört. Ansonsten ist bool 
gleich FALSE. 

Datentyp: 

struct FileHandle *datei; 

Sonstiges: 

Ein virtuellesTerminal ist zum Beispiel die Diskette. Nicht 
virtuell sind die Geräte NIL:, RAW: und CON:. 

10.1.13 Lock 

Syntax: 

lock = Lock(name,mode); 

Funktion: 

Ermittelt die Lock-Structure einer Datei, bzw eines Ver¬ 
zeichnisses. 

Parameter: 

name -> Name der Datei, deren Lock- 

Structure-Zeiger ermittelt werden soll. 

mode -> Für mode muß ACCESS READ an¬ 

gegeben werden, um die Datei zum 
Lesen verwenden zu können. Wird 
ACCESS WRITE angegeben, kann 
die Datei nur beschrieben werden. 

Ergebnis: 

lock -> Zeiger auf die Lock-Structure der 

Datei, bzw. des Verzeichnisses. 

Datentyp: 

char name[]; 

WORD mode; 
struct Lock *lock; 

Sonstiges: 

Im Gegensatz zu Open, wird bei Lock keine Datei geöffnet, 
sondern nur deren Lock-Structure zur Verfügung gestellt, was 
natürlich auch für Datei-Verzeichnisse gilt. So kann dieser 
Befehl verwendet werden, um zu überprüfen, ob eine 
bestimmte Datei vorhanden ist. Ist sie es nicht, ist lock gleich 
0. 

Lock ist ein Puffer, in dem die wesentlichen Merkmale einer 
Datei festgehalten werden. 
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Referenz: 

10.1.14 Open 

Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 

10.1.15 Output 

Syntax: 

Funktion: 


Da Dateien nicht gleichzeitig von mehreren Tasks aus 
beschrieben werden können, bedeutet ACCESSWRITE, 
daß die Datei exclusiv ist. ACCESS READ hingegen 
bedeutet, daß die Datei gleichzeitig von mehreren Tasks aus 
gelesen werden kann. Dazu muß allerdings der Befehl 
DupLock verwendet werden. 

Siehe auch DupLock und UnLock 


datei = Open(name,mode); 

Öffnet eine Datei für Ein- oder Ausgabe. 


name 

-> Name der Datei, die geöffnet werden 
soll. 

mode 

-> MODE OLDFILE öffnet eine bereits 
bestehende Datei mit dem Namen 

»name«. 


MODE NEWFILE erstellt eine neue 
Datei mit dem Namen »name«. 

datei 

-> Zeiger auf die FileHandle-Structure 
der geöffneten Datei, »datei« ist gleich 
0, wenn keine Datei geöffnet werden 
kann. 

char name[]; 
WORD mode; 



struct FileHandle *datei; 

Bevor eine bestehende Datei geöffnet wird, sollte zuvor mit 
Lock getestet werden, ob diese Datei überhaupt besteht. 

Siehe auch Lock, Read, Write und Close 


datei = OutputQ; 

Ermittelt den Zeiger auf die FileHandle der aktuellen 
Ausgabe-Ebene. 


Parameter: 


Keine Parameter. 
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Ergebnis: 

datei -> Zeiger auf die FileHandle-Structure 

der Ebene. 

Datentyp: 

struct FileHandle *datei; 

Sonstiges: 

Die oberste Ausgabeebene ist im Normalfall die Boot-Dis¬ 
kette. 

Referenz: 

Siehe auch Input 

10.1.16 ParentDir 

Syntax: 

parlock = ParentDir(lock); 

Funktion: 

Ermittelt das Directory, in dem sich das angegebene 
Directory, bzw. die Datei befindet. 

Parameter: 

lock -> Zeiger auf die Lock-Structure der 

Datei oder des Verzeichnisses, dessen 
Hauptverzeichnis ermittelt werden soll. 

Ergebnis: 

parlock -> Zeiger auf die Lock-Structure des Ver¬ 

zeichnisses, in dem sich die angegebene 
Datei, bzw. das Verzeichniss befindet. 

Datentyp: 

struct Lock *lock; 
struct Lock *parlock; 

Sonstiges: 

Beispielsweise befindet sich die Datei »test« im Verzeichnis 
»demo«. Wird nun die Lock-Structure der Datei »test« 
angegeben, so erhält man die Lock-Structure des 
Verzeichnisses »demo«. 

Wenn keine Datei »test« gefunden wird, ist parlock gleich 0. 

10.1.17 Read 

Syntax: 

echt = Read(datei,ziel,länge); 

Funktion: 

Liest Daten aus einer geöffneten Datei. 

Parameter: 

datei -> Zeiger auf die FileHandle-Structure 


der Datei, aus der gelesen werden soll. 


ziel -> Zeiger auf das erste Byte des Speicher¬ 

bereiches, in den die Daten geschrie¬ 
ben werden sollen. 

länge -> Länge des Speicherbereiches in Bytes. 



266 Die Ein- und Ausgabe 


Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 

10.1.18 Rename 

Syntax: 

Funktion: 

Parameter: 

Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 


echt -> Anzahl der Bytes, die gelesen werden 

konnten. 

struct FilcHandle *datei; 

ULONG ziel; 
int länge; 
int echt; 

Aus einer Datei kann nur dann gelesen werden, wenn sie 
zuvor mit Open geöffnet wurde. Durch Open erhält man auch 
den Zeiger auf die File-Handle-Structure der Datei. 

»echt«" ist maximal so lang wie »länge«. Ist »echt« gleich -1, 
ist ein Fehler aufgetreten. 

Siehe auch Write, Open und Close 


erfolg = Rename(alt,neu); 

Ändert Datei- oder Dateiverzeichnisnamen. 

alt -> Alter Name der Datei oder des Ver¬ 

zeichnisses. 

neu -> Neuer Name der Datei oder des Ver¬ 

zeichnisses. 

erfolg -> TRUE, wenn kein Fehler aufgetreten 

ist. Ansonsten FALSE. 

char alt[], neu[]; 

bool erfolg; 

Wenn schon eine Datei oder ein Verzeichnis mit dem Namen 

"neu" existiert, wird der Name von "alt" nicht geändert. 

Siehe auch CLI-Befehl rename 
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10.1.19 Seek 

Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


altpos = Seek(datei,pos,mode); 

Stellt den »Schreib/Lesezeiger« einer Datei auf eine neue 


Position. 



datei 

-> 

Zeiger auf die FileHandle-Structure 
der Datei, in der der 

"Schreib/Lesezeiger" neu gesetzt wer¬ 
den soll. 

pos 

-> 

Neue Position des Zeigers. 

mode 

-> 

kann sein: 



OFFSET BEGINNING: neue Position 
vom Dateianfang aus 



OFFSET CURRENT: neue Position 
von der momentanen Position aus 



OFFSET END: neue Position vom 
Dateiende aus. 

altpos 

-> 

Alte Position des Zeigers. 


struct FileHandle *datei; 
int pos; 

WORD mode; 
int altpos; 

Nach dem Öffnen einer Datei mit Open, steht der Zeiger am 
Anfang der Datei. Mit Read oder Write rückt der Zeiger in 
der Datei entsprechend der Anzahl der gelesenen oder 
geschriebenen Bytes weiter. Mit Seek kann dieser Zeiger nun 
vom Programmierer aus selbstständig gesteuert werden. 
Wählt man für "mode" OFFSET_END und für pos gleich -35, 
so bedeutet dies, daß der Zeiger 35 Bytes vor dem Ende der 
Datei positioniert ist. 
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10.1.20 SetComment 

Syntax: erfolg = SetComment(name,kommentar); 

Funktion: Schreibt einen dateispezifischen Kommentar in das Datei¬ 

verzeichnis der Diskette. 

Parameter: name -> Name der Datei oder des Verzeichnis¬ 

ses, für das ein Kommentar gesetzt 
werden soll 

kommentar -> Kommentartext, der maximal 80 Zei¬ 

chen lang sein darf. 

Ergebnis: erfolg -> ist TRUE, wenn kein Fehler auftrat. 

Datentyp: char name[], kommentar[]; 

bool erfolg; 

Sonstiges: Der Kommentar erscheint beim Auflisten des Directory. 

10.1.21 SetProtection 

Syntax: erfolg = SetProtection(name.mode); 

Funktion: Schützt eine Datei oder ein Dateiverzeichnis. 

Parameter: name -> Name der Datei oder des Verzeichnis¬ 

ses, das geschützt werden soll. 

mode -> Siehe Sonstiges. 

Ergebnis: erfolg - > ist TRUE, wenn kein Fehler auftrat. 

Datentyp: char name[]; 

LONG mode; 
bool erfolg; 

Sonstiges: »mode« ist vom Typ LONG, also 32 Bit lang. Die Bits 31 bis 

4 haben derzeit noch keine Bedeutung. 

Bit 3 setzt den Leseschutz (nicht lesbar). 

Bit 2 setzt den Schreibschutz (nicht überschreibbar) 

Bit 1 setzt den Ausführschutz (nicht ausführbar). 

Bit 0 setzt den Löschschutz (nicht löschbar). 
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Soll eine Datei nicht löschbar und nicht überschreibbar sein, 
müssen folgende Bits gesetzt werden: 

00000000000000000000000000000101 * 0X0000000$ 

"mode" muß also gleich 5 sein. 

Mit "mode" gleich 0 werden alle Schutzmaßnahmen außer 
Kraft gesetzt. 


10.1.22 Unlock 

Syntax: 

Funktion: 

Parameter: 

Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 


Unlock(lock); 

Eine Datei oder ein Verzeichniss, auf das z.B. mit Lock zuge¬ 
griffen wurde, kann mit Unlock wieder freigegeben werden. 

lock -> Zeiger auf die Lock-Structure der 

Datei. 

Kein Ergebnis, 
struct Lock *lock; 

Unlock löscht die Lock-Structure aus dem System, die mit 
Lock, DupLock oder CreateDir erstellt wurde. 

Siehe Lock 


10.1.23 WaitForChar 


Syntax: bool = WaitForChar(datei,zeit); 

Funktion: Überprüft, ob ein Zeichen von der spezifizierten Datei inner- 



halb der angegebenen 

Parameter: 

datei -> 


zeit - > 

Ergebnis: 

bool -> 


Zeit bereitgestellt werden kann. 

Zeiger auf die FileHandle-Structure 
der Datei, die überprüft werden soll. 

Zeitspanne, innerhalb der das Zeichen 
bereitgestellt werden muß. 

ist TRUE, wenn das Zeichen innerhalb 
der angegebenen Zeit bereitgestellt 
werden konnte. 
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Datentyp: struct FileHandle *datei; 

LONG zeit; 
bool bool; 

Sonstiges: Die Zeitspanne, innerhalb der das Zeichen bereitgestellt 

werden muß, ist in Mikrosekunden, also millionstel Sekun¬ 
den, anzugeben. 

10.1.24 Write 

Syntax: erfolg = Write(datei,daten,länge); 

Funktion: Schreibt Daten in eine geöffnete Datei. 

Parameter: datei -> Zeiger auf die FileHandle-Structure 

der Datei, in die geschrieben werden 
soll. 

daten - > Zeiger auf das erste Byte des Speicher¬ 

bereiches, der in die Datei geschrieben 
werden soll. 

länge - > Länge des Speicherbereiches in Bytes. 

erfolg -> ist -1, wenn ein Fehler aufgetreten ist 

(beispielsweise "Disk Full") Ist erfolg 
größer als 0, ist kein Fehler aufgetreten 

struct FileHandle *datei; 

ULONG daten; 
int länge; 
int erfolg; 

Sonstiges: In eine Datei kann nur dann geschrieben werden, wenn sie 

zuvor mit Open geöffnet wurde. Durch Open erhält man auch 
den Zeiger auf die File-Handle-Structure der Datei. 

Siehe auch Read, Open und Close 


Ergebnis: 


Datentyp: 


Referenz: 
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10.2 DOS-Demonstration 

Diese Demonstration führen wir als eigenes Unter-Kapitel auf, da sie aus 
zwei Teilen besteht. Der erste Teil ist ein Basic-Programm, das Bilder in ein 
Format wandelt, das mit dem zweiten Programm eingelesen werden kann. 

Um Bilder einiesen zu können, muß also zuerst das Basic-Programm gestar¬ 
tet werden (es befindet sich auch auf der mitgelieferten Diskette). Dazu muß 
sich allerdings der Amiga-Basic-Interpreter auf der Diskette befinden. 
Anschließend fragt es nach dem Namen des Bildes, das konvertiert werden 
soll. Dieses Bild muß im Graphicraft-Format abgespeichert sein, nicht im 
DeLuxePaint-Format. Soll ein DeluxePaint-Bild konvertiert werden, so muß 
dieses zuvor mit Graphicraft geladen und wieder gespeichert worden sein. 

Anschließend fragt das Basic-Programm nach dem Namen, unter dem das 
konvertierte Bild gespeichert werden soll. Das Programm benötigt dann 
einige Zeit, um das Bild zu konvertieren. 

Da das Basic-Programm sehr einfach ist, speichert es nur die Bilddaten ab, 
nicht die Farbinformationen. Diese müssen später im eigenen C-Programm 
gesetzt werden. Es ist allerdings möglich, die Farben mitabzuspeichern, was 
Sie selbst ändern können. 

In Ihr C-Programm können Sie dann die C-Routine einbinden, die das Bild 
einliest. Soll ein Bild nicht eingelesen, sondern auf Diskette gespeichert wer¬ 
den, so sind die »Read«-Befehle gegen »Write«-Befehle auszutauschen. 

Es besteht noch eine weitere Einschränkung. Beide Routinen laden nur Bil¬ 
der mit der Auflösung 320 mal 200 Pixel. Aber auch dies kann von Ihnen 
leicht verändert werden. 

Aber nun zu den Demonstrationen. Auf der Diskette befindet sich ein Bild, 
das eingeladen wird, wenn die DOS-Demonstration gestartet wird. 
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REN t************************************* 

REM Konvertierungsprogranvn von IFF in JKFK 
REM ************************************** 

REM Dieses Programm konvertiert ein Graphicraftbild in ein eigenes Format 
REM Dieses Format besteht allerdings nur aus den Bi ld in-forma tionen 
REM der einzelnen Bitplanes, die hintereinander abgespeichert werden. 

REM ************************************** 

CLS 

INPUT "IFF - File :";a* 

PRINT 

INPUT "JKFK - File :";b* 

REM Screen und Window oeffnen 
SCREEN 1,320,200,5,1 
WINDOW 1 

WINDOW 2,,(0,11>-(310,185),0,1 
WINDOW OUTPUT 2 


REM Datenfelder dimensieren 
DIM ad&(4) 

DIM fr<31),fg(31),fb(31) 

REM IFF-File lesen 

OPEN a$ FOR INPUT AS #1 
a*= INPUT $ (8, # 1) 
a$= I NPUT $ (4, # 1) 

IF a$<>"ILBM" TFEN fehler 
bmhd: 

a$=INPUT*(4,#l) 
a&=CVL(INPUT*(4,#l)> 

IF a*="CMAP" TFEN GOTO cmap 
IF a*="B0DY" TFEN GOTO body 
a*=INPUT$(a&,#l) 

GOTO bmhd 


body: 

REM Plane-Startadressen 
FOR 1=0 TO 4 

ad&(i)=PEEKL(PEEKL(WIND0W(8)+4)+8+4*i) 
NEXT i 

REM IFF-Bilddaten lesen 
FOR y=0 TO 199 
FOR 1=0 TO 4 
ba&=ad&(i)+40*y 

FOR x=0 TO 36 STEP 4 

PÖKEL ba&+x,CVL<INPUTS(4,#1)) 

NEXT x,i,y 
CLOSE »1 


REM JKFK - File abspeichern 

OPEN bS FOR OUTPUT AS #1 LEN=12500 
a=0 
block: 

FOR y= 0 TO 199 
ba& =ad&(a)+40*y 
FOR x=0 TO 36 STEP 4 
PRINT #1,NKL$(PEEKL(ba&+x)); 

NEXT x,y 
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IF a<4 TFEN count: ELSE CLOSE ttl 

END 

count: 

a=a+l 

GOTO block: 

REM Farbmappe lesen 
cmap: 

FÜR i=0 Tü a&/3-l 

■fr ( i )=ASC( INPUT*<1,#1))/16 
■fg(i)=ASC<INPUTt<l,#l))/16 
fb(i)=ASC<INPUT$<1,#1))/16 
PALETTE i, fr(i )/16, fg< i )/16, -fb( i )/16 
NEXT i 
GOTO bmhd 
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/******************************* 

DOS-Demonstration 
last update 26/05/87 
von Frank Kremser und Joerg Koch 
(c) Markt & Technik 1987 

Hc******************************* 

Diese Demonstration oe-ftnet eine Datei mit dem Namen 'Titelbild’ und 
laedt diese in den geoe-f-fneten Screen, dabei wird ein eigenes Screen- 
Format verwendet. Bilder die Graphicraft erstellt wurden, muessen 
zunaechst mit dem Basic-Konvertierer konvertiert werden, bevor sie 
mit dieser Routine ladbar sind. DPaint Bilder muessen dagen zunaechst 
mit Graphicra-ft geladen, abgespeichert und dann konvertiert werden ! 

#*#*****#***###*#####*##*######/ 


#inclüde 
#inclüde 
#include 
#include 
»include 
»include 
»ine lüde 
»include 
»include 
»include 
»include 
»include 
»include 
»include 
#inclüde 
»include 
»include 


<exec/types.h> /# Include-Files laden */ 

<exec/tasks.h> 

<exec/1ibraries.h> 

<exec/devices.h> 

<devices/keymap.h> 

<graphics/copper.h> 

<graphics/display.h> 

<graphics/g-f xbase. h> 

<graphics/text.h> 

<graphics/view.h> 

<graphics/gels.h> 

<graphics/regions.h> 

<graphics/sprite.h> 

<hardware/b1it.h> 

<1ibraries/dos.h> 

<intuition/intuition.h> 

<intuition/intuitionbase.h> 


struct IntuitionBase *IntuitionBase; /# Lib-Zeiger */ 
struct G-fxBase *G-fxBase; 

UL0NG DosBase; 

UBYTE #pufterC53; /# max 5 Pu-f-fer—Zeiger */ 

struct Screen *screen; 
struct NewScreen ns = 


/* Screen de-finieren */ 
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47 

48 

49 

50 

51 

52 
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55 
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58 
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61 
62 

63 
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67 
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74 

75 

76 

77 

78 

79 
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81 
82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101 
102 

103 

104 

105 

106 

107 

108 
109 


{ 

0 , 

0 , 

320, 

200 , 

5, 

0 , 

1 , 

0 , 

CUSTOMSCREEN, 

NULL, 

NULL, 

NULL, 

NULL 

>; 


mam() 

{ 

LGNG warte; 

ULONG datei; 
struct RastPort *rp; 
struct BitMap *ptr; 

i-f ((GfxBase = (struct G-fxBase *) 

OpenLibrary("graphics.1ibrary", 0)) == 0) exit(); 

i-f ((Intuition Base = (struct IntuitionBase *) 

OpenLibrary("intuition.library", 0)) == 0) exit(); 

/* Libs oe-f-fnen */ 

i-f ((DosBase = 

OpenLibrary("dos.library" , 0)) =0) exit(); 

/* Screen oe-f-fnen */ 

i-f ((screen = (struct Screen*) 0penScreen(&ns)) == NULL) exitO; 

•for(warte = 0; warte < 31; ++warte) 

SetRGB4(&screen->ViewPort,warte,0,0,0); /* Farben au-f Schwarz setzen */ 


rp = &screen->RastPort; 
ptr = rp->BitMap; 

pu-f-ferCOD = ptr—>PlanesC03; /* Zeiger au-f BitPlanes ermitteln */ 

pu-f-ferC 13 = ptr >PlanesC 1 ] ; 

pu-f-fer[2] = ptr->Planest2D ; 

pu-f-ferC33 = ptr—>PlanesL3]; 

pu-fterC4D = ptr->PlanesC4]; 


datei = 0pen("titelbild",M0DE_0LDFILE); 
i-f(datei = 0) 

{ 

print-f ( "Keinen File geoe-fnet \n">; 
C1 oseSc reen (sc reen); 
exit(); 

>; 


/* Datei oe-f-fnen */ 


/* Fehler */ 


Read (datei, (Du-f-fer [03 ,8000); /* 
Read (datei, pu-f-ferC 1 ] ,8000); /* 

■Read (datei ,pu-fferC23,8000); /* 
Read(datei, pu-f terC33 ,8000); /* 

Read (datei, pu-f-ferC43 ,8000); 

/* 

/* 

/* 


Datei einladen */ 

Die Laenge berechnet sich aus der */ 
Groesse einer Bitplane = */ 

320 x 200 / 8 */ 

Soll kein Bild gelader», sondern */ 
gespeichert werden, muss anstatt */ 
Read' Write verwendet werden */ 


Close(datei); 


DOS-Demonstration 275 


110 

111 SetFföB4(&screen->Vie*Port,0,0,0,0>; /* Farben fuer Titelbild */ 

1 12 SetRGB4(&screen->ViewPort, 1 ,15,15,15); 

1 13 SetRGB4(&screen->ViewPort,2,14,0,0); 

114 SetRGB4(&screen->ViewPort,3,14, 1 , 0 ); 

115 SetRGB4(&screen->ViewPort,4,14,2,0); 

116 SetRGB4(&screen->ViewPort,5,14,4,0); 

117 SetRGB4(&screen->ViewPurt,6,14,5,0); 

1 18 SetRGB4(&screen->ViewPort,7,14,6,0); 

119 5etRGB4(&screen->ViewPort,8,15,8,0); 

120 SetRGB4(&screen->ViewPort,9,15,9,0); 

121 SetRGB4(&screen->ViewPort,10,15,11,0); 

122 SetRGB4(&screen->ViewPort, 11 ,15,12,0); 

123 SetRGB4(&screen->ViewPort, 12 ,15,14,0); 

124 SetRGB4(&screen->ViewPort,13,15,15,0); 

125 SetRGB4(&screen->ViewPort,14,15,15,4); 

126 SetRGB4(&screen->ViewPort,15,13,15,4); 

127 SetRGB4(&screen->ViewPort,16,10,15,3); 

128 SetRGB4(&screen->0iewPort,17,7,15,3); 

129 SetRGB4<&screen->0iewPort,18,3,15,2); 

130 SetRGB4(&screen->ViewPort,19,2,15,4); 

131 SetRGB4(&screen->ViewPort,20,1,15,6); 

132 SetRGB4(&screen->ViewPort,21,0,15,0); 

133 SetRGB4(&screen->ViewPort,22,1,15,13); 

134 SetRGB4(&screen->ViewPort,23,0,14,15); 

135 SetRGB4(&screen->ViewPort,24,0,12,15); 

136 SetRGB4(&screen->ViewPort,25,0,10,15); 

137 SetRGB4(&screen->ViewPort,26,0,9,15); 

138 SetRGB4(&screen->ViewPort,27,0,7,15); 

139 SetRGB4(&screen->ViewPart,28,0,5,15); 

140 SetRGB4(&screen->ViewPort,29,0,3,15); 

141 SetRGB4(&screen->ViewPort,30,0,2,15); 

142 SetRGB4(&screen->ViewPort,31,0,0,15); 

143 

144 for(warte = 0; warte < 750000; -*-+warte); 

145 

146 CloseScreen(screen); /* Libs and Screen schliessen */ 

147 CloseLibrary(DosBase); 

148 CloseLibrary(IntuitionBase); 

149 CloseLibrary(G-fxBase); 

150 > 
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Der Drucker 


Eines der wichtigsten Geräte des Amiga ist der Drucker. Ohne Drucker geht 
heutzutage gar nichts mehr. Selbst der größte Teil dieses Buches wäre ohne 
die Verwendung eines Druckers nicht zustande gekommen. Deshalb wollen 
wir diesen Teil der Hardware nicht unter den Tisch fallen lassen. 

Der Amiga besitzt vier Möglichkeiten, einen Drucker ansprechen zu können: 

PRT: (Amiga-DOS Printer.device): 

Dies haben Sie sicherlich schon einmal kennengelernt, wenn Sie im CLI 
Dateien auf dem Drucker ausgeben wollten. Unter CLI ist die Anwendung 
sehr einfach, denn es wird einfach nur die Geräteausgabe umgeleitet. Einen 
Text unter CLI können Sie mit »TYPE > PRT: Dateixyz« ausdrucken. 

SER: (Amiga-DOS Seriell.device): 

Wenn der Drucker am Serial-Port angeschlossen ist, kann er mit SER: ange¬ 
sprochen werden. 

PAR: (Amiga-DOS Parallel.device): 

Befindet sich der Drucker aber am Parallel-Port des Amiga, so muß er mit 
der PAR: angesprochen werden. 

Die letzte und variabelste Möglichkeit ist das Ansprechen der printer.device, 
die wir im Kapitel 1.2 »Die Devices« schon kennengelernt haben. 

Printer.device ist eine Art »Software-Drucker-Interface«, die unter Verwen¬ 
dung des mit Preferences eingestellten Printer-Typs, die ankommenden 
Daten für diesen übersetzt. Printer.device stellt dafür drei verschiedene 
Structures zur Verfügung. Der erste, IOPrtCmdReq, dient zur Übertragung 
von Steuerzeichen, die den Drucker z.B. von »Italic« auf »Normal« umstellen 
können. Eine weitere Structure, die IODRPReq, wird benötigt, wenn der 
Inhalt des Screens auf dem Drucker ausgegeben werden soll. Die letzte, 
ebenfalls wichtige Stucture, stellt die printer.device nicht selbst zur Verfü¬ 
gung. Sie muß von Exec geladen werden und dient zum Ausdrucken von 
Texten. 
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11.1 Druckerausgabe über Amiga-DOS 

»PRT:« ist eine der einfachsten Möglichkeiten, Daten zum Drucker zu sen¬ 
den. Der Nachteil ist aber, daß man ausschließlich Texte senden kann. 

Dies geschieht ganz einfach indem man mit 

datei - Open("PRT:”, M0DE_NEWFILE); 

den Druckerport öffnet und anschließend mit 
echt « Write(datei, Stext, sizeof(text)); 

den gewünschten Text ausgibt. Die Variable »echt« entspricht einer Integer¬ 
variable, die die Nummer des Fehlers enthält, falls einer aufgetreten ist. 
»&text« entspricht dem Zeiger auf den Text. Der letzte Parameter ist die 
Länge des Textes. 

Nach diesem Befehl muß der Druckerport wieder geschlossen werden, da 
sonst die Ausgabe des CLI über den Drucker läuft. Dies geschieht mit dem 
Befehl 

Close(datei); 

»PAR:« und »SER:« können ebenfalls angewendet werden. Dabei ist aber zu 
beachten, daß Amiga-DOS die Daten nicht aufbereitet, sondern direkt 
sendet. 
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11.2 Die Printer.device 

Die printer.device ist die Software-Schnittstelle zum Drucker. Mit ihr kön¬ 
nen Steuermodi gesetzt, sowie Screens- und Texte gedruckt werden. 

Zunächst muß man, wie im Kapitel Devices schon beschrieben, einen Port 
und die jeweilige Device, in diesem Fall die printer.device, öffnen. Danach 
kann durch Übergabe einer Structure die gewünschte Funktion 
»eingeschaltet« werden. Es stehen drei Structures und somit drei verschie¬ 
dene Funktionen zur Verfügung: 

- Screen-Hardcopy 

- Übergebenvon Steuerzeichen 

- Ausdruck von Texten 

Die Screen-Hardcopy-Structure IODRPReq ist für das Ausdrucken eines 
Screens, bzw. eines RastPorts zuständig. Sie ist wie folgt festgelegt: 

struct IODRPReq 
{ 

struct Message lo_Message; 
struct Device *io_Device; 
struct Unit *io_Unit; 

UWORD lo_Cominand; 

UBYTE io_Flags; 

BYTE lo_Error; 

stuct RastPort *io_RastPortj 
struct ColorMap *io_ColorMap; 

ULONG iojlodes; 

UWORD io_SrcX; 

UWORD io_SrcY; 

UWORD io_SrcWidth; 

UWORD io_SrcHeightj 
LONG io_DestCols; 

LONG io_DestRovs; 

UWORD io_Special; 

): 


io_Message 

Nachrichten-Struktur. 

io Device 

Zeiger auf die Device. 

io Unit 

Zeiger auf den eigenen Printer-Driver. 

io Command 

Device-Kommando. 

io_Flags 

Ein/Ausgabe-Flags. 

io Error 

Fehler-Nummer. 

io RastPort 

Der RastPort, der ausgegeben werden soll. 

io ColorMap 

Farb-Mappe. 

io Modes 

Der ViewMode. 

io SrcX 

x Ursprung des RastPorts. 

io SrcY 

y Ursprung des RastPorts. 
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Breite des RastPorts. 

Höhe des RastPorts. 

Breite des Ausdrucks in Punkten. 

Höhe des Ausdrucks in Punkten. 

Hier können verschiedene Flags gesetztwerden,die 
den Ausdruck beeinflußen: 


defmition: 

Hex-Wert: Erklärung: 

Special milcols 

0x001: 

Bestimmung der Höhe des 
Dumps in 1/1000. 

Special milrows 

0x002: 

Bestimmung der Breite des 
Dumps in 1/1000. 

Special fullcols 

\ 

0x004: 

Der Ausdruck soll in 
maximaler Breite gesche¬ 
hen. io DestCols und 
io DestRows werden igno¬ 
riert. 

Special fullrows 

0x008: 

Der Ausdruck soll in 
maximaler Höhe gesche¬ 
hen. io DestCols und 
io DestRows werden igno¬ 
riert. 

Special fraccols 

0x010: 

Die Höhe ist ein Bruchteil 
von FULLCOLS. 

SpecialL fracrows 

0x020: 

Die Breite ist ein Bruchteil 
von FULLROWS. 

Sprcial aspect 

0x080: 

io DestRows wird igno¬ 
riert und in Abhängigkeit 
von io DestCols berechnet, 
so daß die Seitenverhält¬ 
nisse übereinstimmen. 

Special densityl 

0x100: 

Dichte-Bits, geringste Auf¬ 
lösung. 

Special density2 

0x200: 

Nächst höhere. 

Special densityß 

0x300: 

Nächst höhere. 

Special density4 

0x400: 

Höchste Auflösung. 


Bei der Anwendung dieser Structure brauchen nicht alle Variablen belegt zu 
werden, da ein Teil der Deklaration von OpenPortQ, sowie OpenDeviceQ 


io_SrcWidth 

ioSrcHeight 

ioDestCols 

ioDestRows 

io_Special 
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übernommen wird. Eine praktische Anwendung dieser Structure zeigt die 
Demonstration »DumpScreen«, die Sie im Anschluß an dieses Kapitel 
finden. 

Die zweite Structure, die in der printer.device enthalten ist, ist die 
IOPrtCmdReq-Structure. Sie wird zum Übergeben von Steuer-Zeichen an 
den Drucker verwendet. 

struct IOPrtCmdReq 
{ 

struct Message lo_Message; 
struct Device *lo_Device; 
struct Unit *io_Unit; 

UWORD io_Comnand; 

UBYTE io_Flags; 

BYTE io_Error; 

UUORD io_PrtCommand; 

UBYTE io_Parn>0; 

UBYTE lo_Parm1j 
UBYTE io_Parn>2; 

UBYTE io_Para5; 

); 

io_Message 
ioDevice 
ioUnit 
io_Command 
io_Flags 
ioError 
io PrtCommand 


io_ParmO 
ioParml 
io_Parm2 
io_Parm3 

Nachdem Sie mit Hilfe dieser Structure den Druckmodus eingestellt haben, 
kann der Text ausgedruckt werden. Ein Beispiel hierfür finden Sie in der 
»Dosprinterdemo«. 

Der Text, der nach dem Einstellen eines Drucker-Kommandos gedruckt 
werden soll, muß mit einer weiteren Structure übergeben werden. Diese 
Structure ist die allgemeine I/O-Structure von EXEC. Nicht alles von dieser 
Structure muß deklariert sein, so daß wir hier nun den benötigten Teil vor¬ 
stellen: 

struct IOStdReq 
{ 

struct Message lo_Message; 


Nachrichten-Struktur. 

Zeiger auf die Device. 

Zeiger auf den eigenen Printer-Driver. 

Device - Kommando. 

Ein/Ausgabe - Flags. 

Fehler-Nummer. 

Hier muß das Kommando für den Drucker einge¬ 
tragen werden. Die Drucker-Kommandos finden 
Sie im Anhang F. 

Parameter für das Kommando. 

Parameter für das Kommando. 

Parameter für das Kommando. 

Parameter für das Kommando (siehe Anhang F). 
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APTR lo_ Data; 

ULONG lo_Lenght; 

) 

io Message : Nachrichten - Struktur. 

io_Data : Zeiger auf den Text, der ausgegeben werden soll. 
io_ Lenght : Länge des Textes. 


Wird in Lenght -1 eingetragen, so bedeutet dies, daß der Text mit 0 enden 
muß. 

1 /******************************* 

2 

3 DOS-Printer-Demonstration 

4 last update 26/05/1987 

5 von Frank Kremser und Joerg Koch 

6 <c) Markt & Technik 1987 

7 *************************(******* 

8 \ 

9 Diese Demonstration verdeutlicht, wie von DOS aus au-f den Drucker 

10 zugegri-f-fen werden kann. DOS-Printer-Demo kann nur vom CLI aus 

11 gestartet werden. 

12 

13 *******************************/ 

14 

15 #include "exec/types.h" /* Include-Files laden */ 

16 #include "exec/exec.h" 

17 ttinclude "libraries/dos.h" 

18 #include "intuition/intuition.h" 

19 

20 ULONG DosBase; /* Lib-Zeiger */ 

21 ULONG datei; /* Zeiger au-f datei */ 

22 

23 char textC] = "Drucker—Demonstratlon\n"; /* Auszugebender Text */ 

24 

25 main() 

26 < 

27 int echt; /* int Variable fuer Fehlermeldung bei WriteO */ 

28 

29 DosBase = OpenLibrary( "dos. 1 ibrary" ,0); /* DOS-Bibl iothek oe-f-fnen #/ 

30 i-f(DosBase = NULL) exitO; 

31 

32 datei = Open ( "PRT: " ,M0DE_NEWFILE); /# Druckerkanal oe-ffnen */ 

33 

34 echt = Write(datei ,&textC0D ,sizeo-f < text)); /* Text schreiben */ 

35 

36 Close(datei); /* Druckerkanal schliessen */ 

37 

38 CloseLibrary(DosBase); 

39 > 


/* DOS-Bibliothek schliessen */ 
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1 


4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 


/****************************** 

Druckerdemonstratlon 
last update 26/05/87 
von Joerg Koch und Frank Kremser 
(c) Markt & Technik 1987 

#*##*#*#***##*#**###*#**#*###*** 

Diese Demonstration verdeutlicht den Umgang mit der Printer-Device. 
Es wird gezeigt, wie Druckereinsteilungen geaendert werden koennen 
und wie Text ausgegeben werden kann. 

Es wird ein Text in Italics ausgegeben. (Auf einem Epson-Drucker 
getestet. 


ttinclude <.exec/types. h> 

#include <exec/exec. h> 

#include <intuition/intuition.h> 
#include <devices/printer.h> 

struct MsgPort *CreatePort(); 
struct MsgPort *printerPort; 

struct IOStdReq druckrequest; 
struct lOPrtCmdReq prefrequest; 


/* Include-Files einiesen */ 

/* Zuweisen der Message-Ports %/ 

/% Structure fuer drucken */ 

/# Structure fuer einstellen */ 


char textC J = "ABCDEFGHIJKLMN0PQRSTLMAJXYZ\n\O'*; /* Auszugebender Text */ 


main() 

int fehler; 

/* Drucker—Port oeffnen %/ 

printerPort = (struct MsgPort *)CreatePort("printer.port",0); 

/% Drucker—Device oeffnen %/ 
fehler = 0penDevice("printer.device”,0,&prefrequest,0); 
if(fehler != 0) 

DeletePort(printerPort); /% Wenn Fehler, Port loeschen */ 

exit(); 

>; 

/* Antwort-Port = Printer-Port */ 
prefrequest.io_Message.mn_ReplyPort = printerPort; 
prefrequest.io_Command = PRD_PRTC0MMAND; /% Print - Kommando #/ 
prefrequest.io_PrtCommand = aSGR3; /* Italics ein #/ 
prefrequest.io_Parm0 = 0; /* keine Parameter #/ 

prefrequest.io_Parml = 0; 
prefrequest.io_Parm2 = 0; 
prefrequest.io_Parm3 = 0; 

fehler = DoIQ(&prefrequest); /# Werte uebergeben %/ 

C1oseDevice(&prefrequest); /% Pref-Device schliessen */ 

/% Druck-Device oeffnen %/ 

fehler = 0penDevice("printer.device",0,&druckrequest,0); 
if(fehler != 0) 

{ 

DeletePort(printerPort); 
exit( ); 

>; 



284 Der Drucker 


65 druckrequest.io_Message.mn_ReplyPort - printerPort; 

66 druckrequest.io_Command = CMDWRITE; /# Kommando Schreiben */ 

67 druckrequest.io_Data = (APTRJ&textCOJ; /* Text uebergeben */ 

68 druckrequest.io_Length = -1; /* Text wird von >0< beendet */ 

69 

70 -fehler = DoIOC&druckrequest); /* Daten uebergeben */ 

71 

72 CloseDevice(&druckrequest); /* Drucker-Device schliessen */ 

73 DeletePort(printerPort); /* Drucker-Port schliessen */ 

74 > 


1 /******************************* 

2 

3 Dump-Demonstration 

4 last update 26/05/87 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt & Technik 1987 

7 

8 ******************************** 

9 

10 Diese Demonstration gibt den Inhalt der Workbench auf dem Drucker aus 

11 x. 

12 ********************************/ 

13 

14 #include <exec/types.h> /* Include-Files laden */ 

15 ttinclude <exec/exec.h> 

16 #include <intuition/intuition.h> 

17 #include <intuition/intuitionbase.h> 

18 #include <devices/printer.h> 

19 

20 extern struct MsgPort *CreatePort(); /* Message-Port zuweisen */ 

21 

22 struct IntuitionBase *IntuitionBase; 

23 struct MsgPort »printerPort; 

24 struct IÜDRPReq request; /* Dump-Structure */ 

25 struct Window *wmdow; 

26 

27 struct NewWindow nw = /* Windowdefinition */ 

28 { 

29 0, 

30 246, 

31 640, 

32 10, 

33 i, 

34 2, 

35 0, 

36 WINDGWDRAG:ACTIVATEIWINDOWDEPTH, 

37 NULL, 

38 NULL, 

39 "Hardcopyroutine von Joerg Koch und Frank Kremser vom 19.4.87 um 4:46", 

40 NULL, 

41 NULL, 

42 0, 

43 0, 

44 0, 

45 0, 

46 WBENCHSCREEN 

47 >; 

48 

49 

50 main<) 
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51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 
81 
82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101 
102 
107 


int fehler; 

struct 5creen *screen; 

IntuitionBase = (struct IntuitionBase *) /# Intuition oe-f-fnen */ 
OpenLibraryt"Intuition.library",0); 
if(IntuitionBase == NULL) exit(); 

window = (struct Window * )OpenWindow(&nw); /* Window oe-f-fnen */ 
if(window == NULL) 

CloseLibrary<IntuitionBase); 
exit(); 

); 


screen = window->WScreen; /# Screen-Structure der */ 

/# Workbench ermitteln #/ 

printerPort = (struct MsgPort *)CreatePort("printer.port" ,0); 
if(printerPort = NULL) exitO; /# Drucker-Port oeffnen */ 

fehler = 0penDevice("printer.device",0,&request,0); 

if(fehler '=0) /# Drucker-Device oeffnen %/ 

< 

CloseLibrary(IntuitionBase); 

DeletePort(printerPort); 
exit(); 

>» 

/* Antwort-Port zuweisen %/ 
request.io_Message.mn ReplyPort = printerPort; 
request.io_Command = PRD_DUMPRP0R7; 

request.io_RastPort = &screen->RastPort; /* RastPort */ 

request.io_ColorNap= screen->ViewPort.ColorMap; /* Farbtabelle */ 
request.io_Modes = screen->ViewPort.Modes; /# Mode */ 

request.io_SrcX = 0; /* des auszugebenden Screens #/ 

request.io_SrcY = 0; 

request.io_SrcWidth = screen->Width; 
request.io_SrcHeight = screen->Height; 

request.ioDestCols = 960; /* Anzahl der Spalten auf dem Papier #/ 

request.io_DestRows = 0; 

request.io_Special = 0x0080; /% ASPECT %/ 

/% SrcX und SrcY geben die Position an, ab der gedruckt werden soll. 

SrcWidth und ScrHeight geben die Hoehe des zu druckenden Bereiches an. Mit 
DestCols wird die Anzahl der Punkte gesetzt, die das Bild auf dem Drucker 
besitzen soll. DestRows braucht nicht gesetzt zu werden, da in Special 
ASPECT = 0x0080 gesetzt ist, was die Reihen automatisch in das richtige 
Verhaeltniss zu den Spalten bringt %/ 


fehler = DoI0(&request); /* Ausgabe auf dem Drucker %/ 


CloseDevice(&request); 

DeletePort(printerPort); 
CloseWindow(window); 


/% Printer-Device schliessen #/ 
/* Printer-Port schliessen */ 

/# Window schliessen */ 
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Die Workbench 


Die Workbench ist wohl jedem Amiga-Benutzer als graphische 
Arbeitsoberfläche bekannt. Doch daß sie auch einige eigene Befehle besitzt, 
dürfte vielen ein Geheimnis sein. Bei genauerer Betrachtung ist es jedoch 
einleuchtend, daß dem so sein muß, denn wie sonst könnte ein Icon von der 
Diskette geholt werden oder auch wieder darauf abgespeichert werden, wenn 
es verändert wurde. 

Die Workbench-Befehle sind normalerweise nicht sehr interessant, da sie 
wohl äußerst selten Verwendung finden. Es ist aber denkbar, daß ein Pro¬ 
gramm die Steuerung der Workbench teilweise übernimmt, wofür die fol¬ 
genden Befehle vonnöten sind. 
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12.1 AddFreeList 

Syntax: fehler = AddFreeList(freelist,anfang,länge); 

Funktion: Fügt einen Speicherbereich in eine FreeList-Structure ein. 


Parameter: 

freelist 

-> 

Zeiger auf die FreeList-Structure, in 
die der Speicherbereich eingefügt wer¬ 
den soll. 


anfang 

-> 

Zeiger auf das erste Byte des Speicher¬ 
bereiches, der eingefügt werden soll. 


länge 

-> 

Länge des Speicherbereiches in Bytes. 

Ergebnis: 

fehler 

-> 

ist 0, wenn kein Fehler aufgetreten ist. 

Datentyp: 

struct FreeList *freelist; 

ULONG anfang; 
int länge; 
int fehler; 

Sonstiges: 

Dieser Befehl 

dient 

dazu, Speicherbereiche zu verwalten. 


Immer wenn ein Programm beendet ist, kann der zugehörige 
Speicherbereich mit AddFreeList in eine FreeList einge¬ 
tragen werden. Diese wird vom System verwaltet, das durch 
solche FreeList’s den freien Speicherplatz ermitteln kann. 

Wird ein neues Programm geladen, kann anhand einer 
FreeList ermittelt werden, an welcher Stelle im Speicher 
genügend freier Platz vorhanden ist. 

Die FreeList-Structure hat folgende Form: 

struct FreeList { 

WORD fl_NumFree; 
struct List fl_MemList; 

>: 

fl_NumFree gibt die Länge eines freien Speicherbereichs in 
8Byte-Blocks an. 

fl_MemList ist eine Unterstruktur, die mehr Einzelheiten 
über diesen Speicherbereich enthält. 

Siehe auch FreeFreeList 


Referenz: 
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12.2 AllocWBObject 


Syntax: 

Funktion: 

Parameter: 

Ergebnis: 

Datentyp: 

Sonstiges: 


Referenz: 


objekt = AllocWBObject(); 

Erstellt eine WBObject-Structure, die für Info-Dateien benö¬ 
tigt wird. 

Keine Parameter. 

objekt -> Zeiger auf die WBObject-Structure. 

struct WBObject *object; 

Der Aufbau der WBObject-Structure ist dem Anhang zu ent¬ 
nehmen. 

Dieser Befehl wird nur verwendet, wenn eine neue 
WBObject-Structure benötigt wird. 

Siehe auch FreeWBObject 
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12.3 BumpRevision 

Syntax: 

länge = BumpRevision(neu,alt); 

Funktion: 

Erzeugt einen neuen Namen für eine kopierte Datei. 

Parameter: 

neu -> Name der Dateikopie. 

alt -> Name des Originals. 

Ergebnis: 

länge -> Länge des Kopienamen. 

Datentyp: 

char neu[], alt[]; 
int länge; 

Sonstiges: 

»neu« muß mindestens 31 Bytes lang sein, da ein Dateiname 
maximal 30 Zeichen lang sein darf und ein Nullbyte als 
Abschluß benötigt wird. 

Der Name ^iör Kopie beginnt im Normalfall mit »copy of«. 
Nur wenn der Dateiname länger als 30 Zeichen wäre, wird 
dieser Text gekürzt. 
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12.4 FreeDiskObject 


Syntax: 

FreeDiskObject(diskobject); 

Funktion: 

Löscht den gesamten Speicher, der von einer Info-Datei 
belegt wird. 

Parameter: 

diskobject -> Zeiger auf die DiskObject-Structure 

der Datei, dessen Info-Datei aus dem 
Speicher gelöscht werden soll. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct DiskObject *diskobject; 

Sonstiges: 

Die Info-Datei enthält solche Daten wie Position des Icons 
und das Icon selbst. 


Zur DiskObjekt-Structure gelangt man über den GetDisk- 
Object-Befehl. 

Referenz: 

Für die DiskObject-Structure siehe Anhang B und GetDisk- 
Object 
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12.5 FreeFreeList 


Syntax: 

FreeFreeList(freelist); 

Funktion: 

Löscht alle Einträge in der spezifizierten FreeList-Structure 
und die Structure selbst. 

Parameter: 

freelist -> Zeiger auf die FreeList-Structure, die 

gelöscht werden soll. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct FreeList *freelist; 

Sonstiges: 

Für weitere Informationen siehe AddFreeList. 

Referenz: 

Siehe auch AddFreeList 
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12.6 FreeWBObject 


Syntax: 

Funktion: 


Parameter: 


FreeWBObject(wbobject); 

Dieser Befehl löscht alle Eintragungen in der spezifizierten 
WBObject-Structure und diese selbst. 

wbobject -> Zeiger auf die WBObject-Structure 

eines Info-Files, die gelöscht werden 
soll. 


Ergebnis: 

Datentyp: 

Sonstiges: 


Referenz: 


Kein Ergebnis. 

struct WBObject *wbobject; 

Dieser Befehl verwendet die AddFreeList-Funktion, um den 
freigewordenen Speicherplatz dem System bekanntzumachen. 

FreeWBObject wird nur dann verwendet, wenn kein Bedarf 
mehr für eine, mit GetWBObject oder AllocWBObject ein¬ 
geladenen, bzw. erstellten WBObject-Structure vorhanden ist. 
Diese enthält die Daten, die aus einer Info-Datei übernom¬ 
men wurden. 

Siehe auch AllocWBObject, GetWBObject, PutWBObject 
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12.7 GetDiskObject 

Syntax: 

diskobject = GetDiskObject(name); 

Funktion: 

Lädt die DiskObject-Structure einer Datei von Diskette. 

Parameter: 

name -> Dateiname, deren DiskObject- 

Structure geladen werden soll. 

Ergebnis: 

diskobject -> Zeiger auf die geladene DiskObject- 

Structure. 

Datentyp: 

char name[]; 

strucLDiskObject *diskobject; 

Sonstiges: 

Die DiskObject-Structure wird für einige Anwendungen, wie 
zum Beispiel für Getlcon, benötigt. 

Referenz: 

Siehe auch PutDiskObject und Getlcon 
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12.8 Getlcon 

Syntax: Status = GetIcon(name,diskobject, freelist); 

Funktion: Gleiche Funktion wie GetDiskObject. 

Parameter: name -> Name der Datei, deren DiskObject- 

Structure geladen werden soll. 

diskobject -> Zeiger auf eine leere DiskObject - 
Structure. 

freelist -> Zeiger auf die FreeList-Structure, aus 

der der benötigte Speicherplatz ent¬ 
nommen werden soll. 

Ergebnis: Status -> ist 0, wenn ein Fehler aufgetreten ist. 

Datentyp: char name[]; 

struct DiskObject *diskobject; 
struct FreeList *freelist; 
int Status; 

Sonstiges: Diese Funktion hat die gleiche Aufgabe wie GetDiskObject. 

Allerdings muß hier der Programmierer mehr in das Gesche¬ 
hen eingreifen. Während sich GetDiskObject automatisch die 
benötigte FreeList-Structure »sucht«, muß sie hier angegeben 
werden. 

Siehe auch GetDiskObject und Puticon 


Referenz: 
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12.9 GetWBObject 


Syntax: 

wbobject = GetWBObject(name); 

Funktion: 

Holt sämtliche Informationen, die in der WBObject-Structure 
gespeichert werden, von Diskette. 

Parameter: 

name -> Name der Datei, von der die Informa¬ 

tionen geholt werden sollen. 

Ergebnis: 

wbobject -> Zeiger auf die WBObject-Structure, 

die nach dem Aufruf des Befehls die 
nötigen Informationen enthält. 

Datentyp: 

char name[); 

struct WBObject *wbobject; 

Sonstiges: 

Dieser Befehl ist nur für Programmierer interessant, die 
direkt in die Workbench-Steuerung eingreifen wollen. 

Referenz: 

Siehe auch PutWBObject 
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12.10 PutDiskObject 


Syntax: Status = PutDiskObject(name,diskobject); 

Funktion: Speichert die Informationen der DiskObject-Structure in der 

Info-Datei einer Datei ab, die mit »name« bezeichnet ist. 


Parameter: 

name 

-> Name der Datei, in deren Info-Datei 
die Informationen gespeichert werden 
sollen. 


diskobject 

-> Zeiger auf die DiskObject-Structure, 
die die Informationen enthält, die 
gespeichert werden sollen. 

Ergebnis: 

Status 

-> ist 0, wenn ein Fehler aufgetreten ist. 

Datentyp: 

char name[]; 

struct DiskObject *diskobject; 
int Status; 

Sonstiges: 

Gegenstück zu 

GetDiskObject. 


Referenz: Siehe auch GetDiskObject 
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12.11 Puticon 

Syntax: Status = PutIcon(name,diskobject); 

Funktion: Speichert die Informationen der DiskObject-Structure in der 

Info-Datei einer Datei ab, die mit »name« bezeichnet ist. 

Parameter: name -> Name der Datei, in deren Info-Datei 

die Informationen gespeichert werden 
sollen. 

diskobject -> Zeiger auf die DiskObject-Structure, 
die die Informationen enthält, die 
gespeichert werden sollen. 

Ergebnis: Status - > ist 0, wenn ein Fehler aufgetreten ist. 

Datentyp: char name[); 

struct DiskObject *diskobject; 
int Status; 


Sonstiges: Gegenstück zu Getlcon. 

Referenz: Siche auch Getlcon 
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12.12 PutWBObject 


Syntax: Status = PutWBObject(name,wbobject); 

Funktion: Speichert die Informationen der WBObject-Structure in der 

Info-Datei einer Datei ab, die mit "name” bezeichnet ist. 


Parameter: 

name 

-> Name der Datei, in deren Info-Datei 
die Informationen gespeichert werden 
sollen. 


wbobject 

-> Zeiger auf die WBObject-Structure, 
die die Informationen enthält, die 
gespeichert werden sollen. 

Ergebnis: 

Status 

-> ist 0, wenn ein Fehler aufgetreten ist. 

Datentyp: 

char name[]; 

struct WBObject *wbobject; 
int Status; 

Sonstiges: 

Gegenstück zu 

GetWBObject. 


Referenz: Siehe auch GctWBObject 




300 Die Workbench 




13 


Die Sprachausgabe 


Die Sprachausgabe des Amiga wird über eine Translator-Library und eine 
Narrator-Device gesteuert. 

Die Translator-Library enthält Befehle, um einen Text zu »übersetzen«, das 
heißt, in eine aussprechbare Form zu bringen. 

Die Translator-Library wird folgendermaßen geöffnet: 

struct Libary »TranslatorBase; 
main() 

{ 

TranslatorBase » OpenLibrary("translator.library”,0); 
if(TranslatorBase ■« NULL) extl(): 


} 

Anschließend kann der Library-Befehl Translate verwendet werden. Dieser 
hat folgende Form: 

fehler = Translate(eingabe,einlänge,ausgabe,auslänge); 


eingabe 

-> 

Zeiger auf den Text, der zu übersetzen ist. 

einlänge 

-> 

Länge des zu übersetzenden Textes. 

ausgabe 

-> 

Puffer, in den der übersetzte Text eingetragen 
werden soll. 

auslänge 

-> 

Länge des Puffers. 

fehler 

-> 

ist > 0, wenn der Puffer nicht groß genug war. 


Ist der Text mit Translate übersetzt worden, so muß er über Narrator-Device 
ausgegeben werden. Da sich die Narrator-Device auf Diskette befindet, muß 
sich die Diskette, die Narrator-Device im Devs-Verzeichnis enthält, in einem 
Laufwerk befinden. 
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Die Narrator-Device ist wie ein normales Device zu behandeln. Allerdings 
enthält sie eine spezielle Structure, die initialisiert werden muß. Diese 
Structure heißt »narrator_rb«. Folgende Werte in ihr müssen deklariert wer¬ 
den: 


message.io_Message.mn_ReplyPort 
message.io_Command 
message.lo_Data 
message.lo_Length 
rate 
pitch 
sex 
ch_masks 
nm_masks 
volume 


Antwort-Port 

Kommando 

Sprachtext 

Länge des Sprachtextes 

Uorte pro Minute 

Grundfrequenz 

Geschlecht 

Ausgabekanäle 

Anzahl der Kanäle 

Lautstärke 


Für »rate« dürfen Werte zwischen 40 und 400 eingegeben werden, »pitch« 
darf Werte zwischen 65 und 320 annehmen. Für das Geschlecht kann MALE 
oder FEMALE angegeben werden. Für die Kanäle kann 3, 5, 10, 12 oder 
jede Kombination davon angegeben werden. 

Anschließend muß mit DoIO der Text ausgegeben werden. 
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/***#***##**#**#****#*#***#*#*#* 

Narrator / Demonstration 
last update 26/05/87 
von Frank Kremser und Joerg Koch 
(c) Markt & Technik 1987 

Lets have Tun. Der Amiga spricht zu Ihnen 
Experimentieren mit den Werten lohnt sich ! 1 ! 

#*##*#****####*##*###**/ 

ttinclude <exec/types.h> /* Includes die wir brauchen */ 

♦tinclude <exec/exec.h> 

ttinclude <intuition/intuition.h> 

#include <devices/narrator .h> 

#include <libraries/translator.h> 

extern struct MsgPort »CreatePort<>; /* Message-Port zuweisen */ 

UL0NG TranslatorBase; /* TranslatorBase -festlegen */ 

struct MsgPort *narratorPort; 

struct narrator_rb request; /# Narrator Structure */ 

UBYTE originaleD = CI AM Y0UR AMIGA">; /* Ausgegebener Text ! */ 
UBYTE translateC500D; /* Translator - Pu-f-fer */ 

BYTE Kanal[43 = <3,5,10,12>; /* Ausgabekanaele setzen */ 


main<) 

{ 

int -fehler; 

/* Uerbersetzungs-Lib oef-fnen */ 
TranslatorBase = OpenLibrary("translator.1ibrary",0); 
i-f(TranslatorBase = NLLL) exit(); 

/* Ausgabeport oe-f-fnen */ 

narratorPort = (struct MsgPort *)CreatePort("narrator.port",0); 
i-f (narratorPort = NULL) exit( ); 

/% Device oe-f-fnen */ 

■fehler = 0penDevice( "narrator .device" ,0,&request,0>; 
i-f (-fehler != 0) 
i 

C1oseLibrary(TranslatorBase); /# wenn Fehler */ 

DeletePort(narratorPort); /% Lib schliessen */ 

exit(); 

>; 

/* Text uebersetzen */ 

-fehler = Translate(&original ,sizeo-f (original > 

,translate,sizeoT(translate)); 


if(-fehler '.= 0) exit(>; 


/# Narrator-Block de-finieren %/ 


request.message.io_Message.mn_ReplyPort = narratorPort; 

request.message.io_Command = CMD_URITE; /% Kommando Schreiben %/ 

request .message. io_Data = (APTR) translate; /# Pointer au-f Text #/ 

request .message.io_Length = sizeoT(translate); /* Groesse des Textes */ 

request.rate = 120; /* Worte pro Minute: 40 < rate < 400 */ 

request.pitch = 230; /* 65 < pitch < 320 #/ 

request.sex = FEMALE; /% Geschlecht : auch MALE #/ 

request.ch_masks — Kanal; /# Kanaele */ 

request .nm_masks = sizeo-f (Kanal); 

request.vo1ume — 64; /% Lautstaerke max 64 %/ 
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65 

66 

fehler = DoIO(&request); 

/* 

Text aussprechen #/ 

67 

68 

CloseDevice(&request); 

/* 

Device schliessen %/ 

69 

DeletePort(narratorPort); 

/* 

Port schliessen */ 

70 

CloseLibrary(TranslatorBase); 

/* 

Lib schliessen #/ 

71 

> 
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Multitasking 


Rechner der neusten Generation, wie die Amiga-Serie, werden nicht nur 
durch ihr sehr gutes Preis-Leistungsverhältnis, sondern auch durch ihr her¬ 
vorragendes Betriebssystem sehr hoch gewertet. Mit diesen neuen Betriebs¬ 
systemen konnten auch erstmals Begriffe wie Multitasking in den Home- und 
Hobby-Computerbereich Vordringen. 

Unter Multitasking versteht man, daß ein Rechner mehrere Aufgaben zur 
»gleichen Zeit« verarbeiten bzw. ausführen kann (Multitasking - > multi = 
mehrere, tasks = Aufgaben). Dem Anwender erscheint es auf jeden Fall so, 
als würde der Rechner mehrere Programme gleichzeitig bearbeiten. In 
Wirklichkeit bearbeitet der Rechner beim Multitasking einen kleinen Teil 
eines Programmes, bricht es ab und beginnt mit der Bearbeitung eines wei¬ 
teren Programmes, bricht dies wieder ab und führt die Bearbeitung des 
ersten Programmes an der Abbruchstelle fort. Der Rechner springt also zwi¬ 
schen den Programmen hin und her. Dies geschieht so schnell, daß der An¬ 
wender meint, die Programme würden parallel ablaufen. Diese Methode 
wird auch als »Scheduling« bezeichnet. 

Voraussetzungen zum Multitasking sind einmal ein schneller Prozessor, der 
Amiga besitzt den MC68000 von Motorola, viel Speicher, da die Tasks ver¬ 
waltet werden müssen, und ein Betriebssystemkern, der multitaskingfähig ist. 
Darunter versteht man, daß dieses Betriebssystem die Verwaltung der 
Arbeitsprozesse (Tasks) übernehmen kann. 

Das Amiga-Betriebssystem besitzt einen hervorragenden Kern, dieser wird 
EXEC (executive - ausführend) genannt. EXEC übernimmt die komplette 
»Kontrolle« des MC68000, teilt die Zeit für verschiedene Tasks ein, über¬ 
nimmt Ein- und Ausgabefunktionen, die Vermittlung von Nachrichten und 
noch einiges mehr. EXEC ist, aufgrund seiner Wichtigkeit, das einzige 
Library, das beim Amiga jederzeit geöffnet ist. Nun aber zurück zum 
Multitasking. 
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Zwei Möglichkeiten die Multitaskingfähigkeiten des Amiga zu entlocken, hat 
bestimmt schon jeder Amiga-Besitzer kennengelernt. Zunächst ist da das 
Starten von Programmen von der Workbench aus. Jedes Programm, das 
durch Anklicken der Maustaste aufgerufen wird, wird als separater Task 
behandelt. Eine weitere Möglichkeit bietet das CLI: durch den Befehl 
»RUN« kann ein Programm als separater Task gestartet werden. Die dritte 
Möglichkeit ist das Starten von Tasks in eigenen Programmen. So kann man 
z.B. zwei Windows öffnen und »gleichzeitig« in beiden verschiedene Linien 
Zeichen oder Berechnungen als Tasks ausführen. Dem Multitasking ist hier 
nur iii der Anzahl und in dem vorhandenen Speicherplatz eine Grenze 
gesetzt, denn je mehr Tasks, desto mehr Speicherplatz und desto langsamer 
wird das System. 

Multitasking in eigenen Programmen setzt nach der Meinung von Experten 
gewisse Grundkenntnisse des Betriebssystemkerns EXEC und des Multi¬ 
taskingsystems voraus. Das EXEC Support Library enthält jedoch Funk¬ 
tionen, die den Umgang mit Multitasking in eigenen Programmen erheblich 
vereinfachen. Der Anwender braucht somit kaum Vorkenntnisse, jedoch 
werden die Möglichkeiten des Multitasking nicht vollkommen ausgeschöpft. 

Bei Verwendung des Multitasking in eigenen Programmen werden neben der 
Hauptroutine verschiedene Unterroutinen benötigt, die mit CreateTask als 
separate Tasks aufgerufen werden können. Die Funktion CreateTask 
übernimmt für uns alle wichtigen Einrichtarbeiten, die zum »Anheften« von 
Tasks an das System notwendig sind. Mit CreateTask muß auch eine Priori¬ 
tät des jeweiligen Task übergeben werden, damit ist die Wichtigkeit des 
jeweiligen Tasks gemeint. Sie muß mit der Priorität der Hauptroutine abge¬ 
stimmt sein. Ist z.B. die Priorität des Tasks kleiner als die der Hauptroutine, 
so wird der Task erst gar nicht ausgeführt. Die Task-Priorität kann einen 
Wert von -128 bis +127 annehmen, wobei -128 die niedrigste Priorität dar¬ 
stellt. Die meisten Tasks des Amiga-Systems liegen im Bereich von -20 bis 
+ 20. Soll die Priorität eines Programms nachträglich geändert werden, so 
kann das mit der Funktion ChangePri() geschehen. Nachdem der Task seine 
Aufgabe erfüllt hat, muß er wieder aus der Task-Liste des Systems mit 
DeleteTaskQ oder RemTaskQ gelöscht werden. 
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14.1 ChangePri 


Syntax: ChangePri(Task, Priorität); 

Funktion: Ändert die Priorität eines Tasks. 


Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


Task -> Zeiger auf die Task-Structure des 

Tasks, dessen Priorität geändert wer¬ 
den soll. 

Priorität -> Die neue Priorität des Tasks. Der Wert 

kann zwischen -128, niedrigste Priori¬ 
tät, und +128, höchste Priorität liegen. 

Kein Ergebnis. 

struct Task Task; 

BYTE Priorität; 

Die Priorität der Tasks muß, wenn sie von einem Haupt¬ 
programm aufgerufen wird, mit der Priorität des Haupt¬ 
programms abgestimmt werden. 
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14.2 CreateTask 


.Syntax: 

Task = CreateTask(&Name[0], Priorität, &Funktion[0], 
Stack); 

Funktion: 

Bildet einen Task. 

Parameter: 

&Name[0] -> Beliebiger Name für den Task. 

Priorität -> Priorität des Tasks. 

&Funktion[0] -> Die Unterroutine, die als Task aufge¬ 
rufen werden soll. 

Stack -> Speicher für den Task. 

Ergebnis: 

Task -> Zeiger auf die Task-Structure des 

neuen Tasks. Ist sie NULL, so konnte 
kein neuer Task erzeugt werden. 

Datentyp: 

char Name[]; 

BYTE Priorität; 
char Funktion[]; 

LONG Stack; 
struct Task Task; 

Sonstiges: 

Die Priorität des Tasks kann später mit ChangePri geändert 
werden. Der Speicher für den Task ist von der Größe des 
jeweiligen Programms abhängig. Ein Speicher von 20000 
Bytes reicht aber in jedem Fall aus. 

Referenz: 

Eine Anwendungsmöglichkeit finden Sie in dem Programm 
Multidemo. 
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14.3 DeleteTask 


Syntax: 

DeleteT ask(T ask); 

Funktion: 

Löscht einen Task. 

Parameter: 

Task -> Zeiger auf die Task-Structure des 

Tasks, der gelöscht werden soll. 

Ergebnis: 

Kein Ergebnis. 

Datentyp: 

struct Task Task; 

Sonstiges: 

Ein Task kann auch mit der Funktion RemTaskQ gelöscht 
werden. 

Referenz: 

Siehe auch RemTask 
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14.4 RemTask 


Syntax: 

RemTask(Task); 


Funktion: 

Löscht einen Task. 


Parameter: 

Task -> 

Zeiger auf die Task-Structure 
Tasks, der gelöscht werden soll. 

Ergebnis: 

Kein Ergebnis. 


Datentyp: 

struct Task Task; 


Sonstiges: 

Ein Task kann auch 

mit DeleteTask gelöscht werden. 

Referenz: 

Siehe auch DeleteTask 
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/******************************* 


Multitasking-Demonstration 
last update 26/05/8/ 
von Joerg Koch und Frank Kremser 
(c) Markt und Technik 1987 


******************************** 

Einfache Multitasking-Demo. Zwei Unterfunktionen werden als Tasks 
gestartet. 

*******************************/ 


#inclüde 
#include 
#include 
#include 
#include 
#inclüde 
#inclüde 
#include 
#include 
#include 
ttinclude 
#include 
ttinclude 
#include 
ttinclude 
#include 
#include 
#include 
#include 


<exec/types.h> /* Include-Files laden */ 

<exec/tasks.h> 

<exec/1ibrarles.h> 

<exec/devices.h> 

<exec/memory.h> 

<exec/exec base.h> 

<exec/exec.h> 

<devices/keymap.h> 

<graphics/copper.h> 

<graphics/display.h> 

<graphics/gfxbase.h> 

<graphics/tex t.h> 

<graphics/view.h> 

<graphics/gels.h> 

<graphics/regions.h> 

<graphics/sprite.h> 

< hardware/b1it.h> 

Cintuition/intuition.h> 

<intuition/intuitionbase.h> 


struct IntuitionBase *IntuitionBase; /* Lib - Zeiger */ 
struct GfxBase *GfxBase; 
struct ExecBase *ExecBase; 

int endel, ende2; 

struct Task *tl, *t2; 


/* Task - Zeiger */ 
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43 

44 

struct Window *wl, *w2; 

/# Window - Zeiger %/ 

45 

46 

struct NewWindow nwl = 

/% Window fuer Task 1 definieren 

47 

< 


48 

30, 


49 

30, 


50 

280, 


51 

200, 


52 

2, 


53 

1. 


54 

NULL, 


55 

NULL, 


56 

NULL, 


57 

NULL, 


58 

"Task Nummer 1", 


59 

NULL, 


60 

NULL, 


61 

o, 


62 

0, 


63 

o, 


64 

0, 


65 

WBENCHSCREEN 


66 

>; 


67 

68 

struct Net^indow nw2 = 

/% Window fuer Task2 definieren %/ 

69 



70 

350, 


71 

30, 


72 

280, 


73 

200, 


74 

2, 


75 

1, 


76 

NULL, 


77 

NULL, 


78 

NULL, 


79 

NULL, 


80 

"Task Nummer 2", 


81 

NULL, 


82 

NULL, 


83 

0, 


84 

0, 


85 

o, 


86 

o, 


87 

WBENCHSCREEN 


88 

>; 


89 

90 

91 

task1() 

/% Unterfunktion */ 

92 


/* wird als Task 1 gestartet */ 

93 

LONG warte; 


94 

int schleife; 


95 

96 

wl = (struct Window #>QpenWindow(&nwl); /* Window oeffnen %/ 

97 

SetDrMd(w1->RPort,JAMI); 


98 

SetAPen(wl->RPort,3); 


99 

for(schleife = 10; schleife<200; 

; schleife=schleife+2) 

100 

C 


101 

Move(wl->RPort,0,schleife); 

/* Gitter zeichnen */ 

102 

Draw(wl->RPort,280,schleife): 


103 

>; 


104 

105 

for(schleife = 0; schleife<280; 

sch1eife=sch1eife+2) 
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106 { 

107 Move(wl->RPort,schleife,10); /* Gitter zeichnen */ 

108 Draw(wl->RPort,schleife,200); 

109 >; 

110 

111 for(warte = 0; warte < 50000; warte++); 

112 CloseWmdow(wl); /* Task fertig, Window #/ 

113 endel =1; /* schliessen %/ 

114 > 

115 

116 task2() 

117 ( 

118 LONG warte; 

119 int schleife; 

120 

121 w2 = (struct Window *)0penWindow(&nw2); /* Window Task2 oeffnen */ 

122 SetDrf4d(w2->RPort, JAM1); 

123 SetAPen(w2->RPort,1); 

124 for(schleife = 10; schleife<200; schleife=schleife+2) 

125 < 

126 Move(w2->RPort,0,schleife); /* Gitter zeichnen #/ 

127 Draw(w2->RPort,280,schleife); 

128 >; 

129 

130 for(schleife = 0; schleife<280; schleife=schleife+2) 

131 { 

132 Move(w2->RPort,schleife,10); 

133 Draw(w2->RPort,schleife,200); /* Gitter zeichnen #/ 

134 >; 

135 

136 for(warte = 0; warte < 50000; warte++); /# Task fertig, */ 

137 CloseWindow(w2); /* Window schliessen #/ 

138 ende2 = 2; 

139 > 

140 

141 

142 main() /* Hauptprogramm #/ 

143 C 

144 LONG warte; 

145 

146 endel = ende2 = 0; /* ExecBase oeffnen */ 

147 

148 ExecBase = (struct ExecBase *)0penLibrary("exec.1lbrary",0); 

149 

150 IntuitionBase = (struct IntuitionBase *) /% IntuiH_ib oeffnen */ 

151 0penLibrary("intuition.library",0); 

152 

153 GfxBase = (struct GfxBase *) 

154 0penLibrary("graphics.1ibrary",0); 

155 /* Task 1 und Task 2 bilden und #/ 

156 /# starten %/ 

157 

158 t2 = (struct Task *)CreateTask("Task 2",0,task2,5000); 

159 tl = (struct Task *)CreateTask("Task 1",0,taskl,5000); 

160 

161 while((endel = 0) && (ende2 == 0)); /* beide fertig, dann Ende */ 

162 

163 for(warte = 0; warte < 50000; warte++); 

164 

165 

166 CloseLibrary(IntuitionBase); /* Libs schliessen */ 

167 CloseLibrary(GfxBase); 

168 CloseLibrary(ExecBase); 

169 > 
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Der Amiga stellt verschiedene Bibliotheken mit mathematischen Befehlen 
bereit. Zwar sind viele dieser Befehle auch schon von »C« aus vorhanden, 
doch benötigen diese ein Vielfaches der Zeit. Dies trifft vor allen Dingen auf 
die Funktionen des Lattice-C-Compilers zu, da dieser sämtliche Gleit¬ 
kommazahlen mit doppelter Genauigkeit berechnet. 

Dieser Punkt bringt noch weitere Schwierigkeiten mit sich. Da der Lattice-C- 
Compiler sämtliche Gleitkomma-Zahlen mit doppelter Genauigkeit speichert 
und berechnet, treten Probleme auf, wenn die mathematischen Befehle, die 
mit einfacher Genauigkeit rechnen, verwendet werden. In diesem Fall wer¬ 
den nämlich sämtliche Ergebnisse falsch interpretiert. Um dieses Problem zu 
umgehen, muß ein Trick angewendet werden. Dies gilt, wie schon gesagt, nur 
für den Lattice-C-Compiler. Die Besitzer eines Aztec-Compilers können für 
sämtliche Funktionen, die FFP-Zahlen verarbeiten, FLOAT-Werte angeben. 
Das bedeutet, sämtliche »ffp«-Variablen können mit »FLOAT ffpl, ffp2, 
...usw.« deklariert werden. 

Die Besitzer eines Lattice-C-Compiler müssen folgenden Trick anwenden: 


main() 

/* Deklarieren einer Structure, bestehend */ 

/* aus einer FLOAT- und einer Integer- */ 

/* Variablen, »unlon« bewirkt, das beide */ 

/* Elemente der Structure ander relativen */ } 

/* zahl */ 

/* Adresse 0 beginnen. Der Name der Structure */ 
/* ist »zahl« */ 

/* Variable belegen */ 
zahl.int = SPFieee(zahl.int) 

/* Variable in FFP-Format wandeln »/ 
xyz » SPSqrt(zahl.int); /» Nun kann gerechnet werden «/ 


unlon test 
{ 

FLOAT ffp; 
int intj 


zahl.ffp = 0.7; 


Diese Methode ist zwar recht umständlich, ist aber leider nicht zu vermeiden. 
Dafür steigt die Rechengeschwindigkeit enorm an. 

Besitzer neuerer Lattice-Versionen können dieses Problem beseitigen, indem 
Sie einen Compiler-Schalter setzen. Ziehen Sie dazu bitte Ihr Handbuch zu 
Rate. 
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15.1 Mathematische Grundfunktionen 


Die mathematischen Grundfunktionen befinden sich in der »mathhffp«. Um 
sie verwendet zu können, muß die Include-Datei »math.h« eingelesen wer¬ 
den. Im Anschluß daran müssen die Funktionen extern bereitgestellt werden. 
Dazu dient die »extern«-Funktion. Dies müssen ausschließlich die Lattice- 
Besitzer einfügen, da dies mit den oben genannten Problemen in Verbindung 
steht. Anschließend muß die »mathffp«-Library geöffnet werden. Ist dies 
geschehen, so können die Funktionen verwendet werden. Im Programm 
könnte das folgendermaßen aussehen: 

/lnclude <exec/types.h> 

/include <math.h> 

extern lnt SPFix; /* Nur für Lattice-Besit 2 er */ 

extern int SPAbs; 

usv. 

extern int SPDiv; 


main() 

{ 

Union test /* Für Lattlce-Besitzer */ 
{ 

FLOAT ffp; 
int int; 

} zahl; 


} 


FLOAT ffp; /* Für Aztec-Besltzer */ 

ULONG MathBase; 

/* Library öffnen */ 

if((MathBase = OpenLibraryt"mathffp.library”,0)) == 
/* Berechnungen s.o. */ 

CloseLibrary(MathBase); 


0 ) 


exit(); 


Nach diesem Schema können Sie also Vorgehen. Wollen Sie Ihre Berechnun¬ 
gen mit doppelter Genauigkeit ermitteln, so können Sie die 
»mathieeedoubbas.library« verwenden. Diese Befehle können sehr einfach 
verwendet werden. Dazu gehen wir folgendermaßen vor: 

/include <exec/types.h> 

/include <math.h> 

main() 

{ 

double ffpl, ffp2; 

ULONG MathleeeDoubBasBase; 

/* Library öffnen */ 
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if((MathBase * OpenLibraryt"mathleeedoubbas.library”,0)) ** 0) 
exit(); 

ffp1 * -25.4567; /* Variable belegen */ 

ffp2 - XEEEDPNeg(ffp1); /* Berechnung */ 

CloseLibrary(MathleeeDoubBasBase); 

} 

Diese Befehle mit doppelter Genauigkeit haben wir nicht extra aufgeführt, da 
sie mit den nachfolgenden Befehlen mit einfacher Genauigkeit fast überein¬ 
stimmen. Wenn der Befehl mit einfacher Genauigkeit die Form »SPSub« hat, 
so hat der Befehl mit doppelter Genauigkeit die Form »IEEEDPSub«. 

15.1.1 SPFix 


Syntax: 

int = SPFix(ffp); 

Funktion: 

Wandelt eine FFP- in eine Integer-Zahl um. 

Parameter: 

ffp -> FFP-Zahl, die umgewandelt werden 

soll. 

Ergebnis: 

int -> Integer-Zahl. 

Datentyp: 

FLOAT ffp; 
int int; 

Sonstiges: 

Diese Funktion hat die gleiche Wirkung wie die Absolutfunk¬ 
tion. 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 


Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: Siehe auch SPAbs 


15.1.2 SPFlt 


Syntax: 

ffp = SPFlt(int); 


Funktion: 

Wandelt eine Integer¬ 

in eine FFP-Zahl um. 

Parameter: 

int -> 

Integer-Zahl, die umgewandelt werden 
soll. 

Ergebnis: 

ffp -> 

FFP-Zahl. 

Datentyp: 

int int; 

FLOAT ffp; 
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Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

15.1.3 

SPCmp 



Syntax: 

int = SPCmp(ffpl, ffp2); 


Funktion: 

Vergleicht zwei FFP-Zahlen miteinander. 


Parameter: 

ffpl, ffp2 -> FFP-Zahlen, die verglichen werden 

sollen. 


Ergebnis: 

int -> Wenn ffpl kleiner als ffp2 ist, ist int 

gleich -1, ist ffpl größer als ffp2, so ist 
int gleich +1. Sollten beide FFP-Zah¬ 
len gleich sein, so ist int gleich 0. 


Datentyp: 

FLOAT ffpl, ffp2; 
int int; 


Sonstiges: 

Die Funktion SPCmp liefert das gleiche Ergebnis wie eine 
Signum-Funktion. 



Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

15.1.4 

SPTst 



Syntax: 

int = SPTst(ffp); 


Funktion: 

Testet eine FFP-Variable auf 0. 


Parameter: 

ffp -> Zahl, die auf 0 getestet werden soll. 


Ergebnis: 

int -> Wenn ffpl kleiner als 0 ist, ist int gleich 

-1, ist ffpl größer als 0, so ist int gleich 
+ 1. Sollte die FFP-Zahl gleich 0 sein, 
so ist int gleich 0. 


Datentyp: 

FLOAT ffp; 
int int; 


Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bcrcitgestellt werden muß. 
Siehe dazu Kapitel 15. 
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SPAbs 



Syntax: 

ffpl = SPAbs(ffp2); 


Funktion: 

Ermittelt den Absolutwert einer FFP-Zahl. 

Parameter: 

ffp2 -> 

FFP-Zahl, deren Absolutwert ermittelt 
werden soll. 

Ergebnis: 

ffpl -> 

Absolutwert von ffp2. 

Datentyp: 

FLOAT ffp2; 
FLOAT ffpl; 


Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: 

Siehe auch SPFix 



15.1.6 SPNeg 

Syntax: 

Funktion: 

Parameter: 

Ergebnis: 

Datentyp: 

Sonstiges: 


15.1.7 SPAdd 

Syntax: 

Funktion: 

Parameter: 

Ergebnis: 


ffpl = SPNeg(ffp2); 

Ermittelt das Negat einer FFP-Zahl. 

ffp2 -> FFP-Zahl, deren Negat ermittelt wer¬ 

den soll. 

ffpl -> Negat der FFP-Zahl. 

FLOAT ffp2; 

FLOAT ffpl; 

Das Negat bedeutet, daß eine positive Zahl negativ wird und 
umgekehrt. Auf die Zahl 0 hat diese Funktion keinen Einfluß. 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 


ffpl = SPAdd(ffp2, ffp3); 

Addiert zwei FFP-Zahlen. 

ffp2, ffp3 -> FFP-Zahlen, die addiert werden sollen, 

ffpl -> Summe der beiden FFP-Zahlen. 
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Datentyp: FLOAT ffp2, ffp3; 

FLOAT ffpl; 

Sonstiges: Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 

Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: Siehe auch SPSub 

15.1.8 SPSub 

Syntax: 

Funktion: 

Parameter 

Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 

15.1.9 SPMul 


Syntax: 

ffpl = SPMul(ffp2, ffp3); 

Funktion: 

Multipliziert zwei FFP-Zahlen miteinander. 

Parameter: 

ffp2, ffp3 -> 

FFP-Zahlen, die miteinander multipli¬ 
ziert werden sollen. 

Ergebnis: 

ffpl -> 

Produkt der beiden FFP-Zahlen. 

Datentyp: 

FLOAT ffp2, ffp3; 
FLOAT ffpl; 


Sonstiges: 

Es ist zu beachten, 

daß die FFP-Zahl bei dem Lattice-C- 


Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 


ffpl = SPSub(ffp2, ffp3); 

Subtrahiert zwei FFP-Variablen voneinander. 

ffp2 -> FFP-Zahl, von der subtrahiert werden 

soll. 

ffp3 -> FFP-Zahl, die subtrahiert werden soll. 

ffpl -> Differenz zwischen den beiden FFP- 

Zahlen. 

FLOAT ffp2, ffp3; 

FLOAT ffpl; 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Siehe auch SPAdd 


Referenz: 


Siehe auch SPDiv 
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15.1.10 SPDiv 

Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


Referenz: 


ffpl = SPDiv(ffp2, ffp3); 

Dividiert zwei FFP-Variablen. 

ffp2 -> FFP-Zahl, die dividiert werden soll. 

ffp3 -> FFP-Zahl, durch die dividiert werden 

soll. 

ffpl -> Ergebnis der Division. 

FLOAT ff P 2, ffp3; 

FLOAT ffpl; 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Siehe auch SPMul 
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15.2 Transzendale Funktionen 

Auf den nachfolgenden Seiten werden die Funktionen aufgeführt, die über 
die Grundfunktionen hinausgehen. Für die FFP-Werte, mit denen sie rech¬ 
nen, gelten die gleichen Bedingungen, wie für die Grundfunktionen. Lesen 
Sie also bitte auch die Kapitel 15 und 15.1. Um die Befehle verwenden zu 
können muß zusätzlich zur »mathffp«-Library noch die »mathtrans«-Library 
geöffnet werden. Im Programm könnte das folgendermaßen aussehen: 

/Include <exec/types.h> 

/include <math.h> 

extern lnt SPAsln; /* Nur für Lattice-Besltzer */ 
extern lnt SPAcos; 


usu. 


extern lnt SPFleee; 

main() 

{ 

Union test /* Für Lattice-Besltzer */ 

( 

FLOAT ffp; 
lnt lnt; 

} zahl; 

FLOAT ffp; /* Für Aztec-Besltzer */ 

ULONG MathBase; 

ULONG MathTransBase; 

/* Libraries öffnen */ 

if((MathBase = OpenLibraryC’mathffp.llbrary“,0)) ** 0) exlt(); 

1f((MathTransBase = OpenLlbraryt"mathtrans.llbrary”,0)) «■ 0) 
exlt(); 


/* Berechnungen s.o. */ 


CloseLibrary(MathTransBase); 
CloseLibrary(MathBase); 
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15.2.1 

SPAsin 



Syntax: 

ffpl = SPAsin(ffp2); 


Funktion: 

Ermittelt den Arcussinus einer FFP-Zahl. 


Parameter: 

ffp2 -> Sinuswert, dessen zugehöriger Winkel 

ermittelt werden soll. 


Ergebnis: 

ffpl -> Winkel im Bogenmaß (Radiant). 


Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 


Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 


Referenz: 

Siehe auch SPAcos und SPAtan 

15.2.2 

SPAcos 



Syntax: 

ffpl = SPAcos(ffp2); 


Funktion: 

Ermittelt den Arcuscosinus einer FFP-Zahl. 


Parameter: 

ffp2 -> Cosinuswert, dessen zugehöriger Win¬ 

kel ermittelt werden soll. 


Ergebnis: 

ffpl -> Winkel im Bogenmaß (Radiant). 


Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 


Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 


Referenz: 

Siehe auch SPAsin und SPAtan 

15.2.3 

SPAtan 



Syntax: 

ffpl = SPAtan(ffp2); 


Funktion: 

Ermittelt den Arcustangens einer FFP-Zahl. 


Parameter: 

ffp2 -> Tangenswert, dessen zugehöriger Win¬ 

kel ermittelt werden soll. 


Ergebnis: 

ffpl -> Winkel im Bogenmaß (Radiant). 
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Datentyp: FLOAT ffp2; 

FLOAT ffpl; 

Sonstiges: Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 

Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: Siehe auch SPAsin und SPAcos 


15.2.4 SPSin 


Syntax: 

ffpl = SPSin(ffp2); 

Funktion: 

Ermittelt den Sinus einer FFP-Zahl. 

Parameter: 

ffp2 -> Winkel im Bogenmaß, dessen Sinus 

ermittelt werden soll. 

Ergebnis: 

ffpl -> Sinuswert des Winkels. 

Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 

Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: 

Siehe auch SPCos und SPTan 

SPCos 

Syntax: 

ffpl = SPCos(ffp2); 

Funktion: 

Ermittelt den Cosinus einer FFP-Zahl. 

Parameter: 

ffp2 -> Winkel im Bogenmaß, dessen Cosinus 

ermittelt werden soll. 

Ergebnis: 

ffpl -> Cosinuswert des Winkels. 

Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 

Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: 

Siehe auch SPSin und SPTan 



Transzendale Funktionen 323 


15.2.6 

SPTan 



Syntax: 

ffpl = SPTan(ffp2); 


Funktion: 

Ermittelt den Tangens einer FFP-Zahl. 


Parameter: 

ffp2 -> Winkel im Bogenmaß, dessen Tangens 

ermittelt werden soll. 


Ergebnis: 

ffpl -> Tangenswert des Winkels. 


Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 


Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 


Referenz: 

Siehe auch SPSin und SPCos 

15.2.7 

SPSincos 



Syntax: 

ffpl = SPSincos(&ffp2, ffp3); 


Funktion: 

Ermittelt Sinus und Cosinus einer FFP-Zahl. 


Parameter: 

ffp3 -> Winkel im Bogenmaß, dessen Sinus 

und Cosinus ermittelt werden soll. 



&ffp2 -> Zeiger auf eine FFP-Variable, in der 

der Cosinuswert gespeichert werden 
soll. 


Ergebnis: 

ffpl -> Sinuswert des Winkels. 


Datentyp: 

FLOAT ffp2, ffp3; 

FLOAT ffpl; 


Sonstiges: 

Da eine Funktion höchstens einen Wert direkt zurückgeben 
kann -hier ffpl-, muß der zweite Wert in einer Variablen 
gespeichert werden. Um dies zu können, muß der Funktion 
»gezeigt« werden, an welcher Stelle sie dies tun soll. Dazu 
dient »&ffp2«. »&« ermittelt die Adresse der Variablen 
»ffp2« und übergibt diese der Funktion, die an dieser Stelle 
den Cosinuswert speichert. 



Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 


Referenz: 

Siehe auch SPSin und SPCos 
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15.2.8 

SPSinh 



Syntax: 

ffpl = SPSinh(ffp2); 


Funktion: 

Ermittelt den hyperbolischen Sinus einer FFP-Zahl. 


Parameter: 

ffp2 -> FFP-Zahl, deren hyperbolischer Sinus 

ermittelt werden soll. 


Ergebnis: 

ffpl -> enthält den hyperbolischen Sinus. 


Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 


Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 


Referenz: 

Siehe auch SPCosh und SPTanh 

15.2.9 

SPCosh 



Syntax: 

ffpl = SPCosh(ffp2); 


Funktion: 

Ermittelt den hyperbolischen Cosinus einer FFP-Zahl. 


Parameter: 

ffp2 -> FFP-Zahl, deren hyperbolischer Cosi¬ 

nus ermittelt werden soll. 


Ergebnis: 

ffpl -> enthält den hyperbolischen Cosinus. 


Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 


Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 


Referenz: 

Siehe auch SPSinh und SPTanh 

15.2.10 SPTanh 



Syntax: 

ffpl = SPTanh(ffp2); 


Funktion: 

Ermittelt den hyperbolischen Tangens einer Zahl. 


Parameter: 

ffp2 -> FFP-Zahl, deren hyperbolischer Tan¬ 

gens ermittelt werden soll. 


Ergebnis: 

ffpl -> enthält den hyperbolischen Tangens. 
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Datentyp: 

Sonstiges: 

Referenz: 

15.2.11 SPExp 

Syntax: 

Funktion: 

Parameter: 

Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 

15.2.12 SPLog 

Syntax: 

Funktion: 

Parameter: 

Ergebnis: 

Datentyp: 

Sonstiges: 

Referenz: 


FLOAT ffp2; 

FLOAT ffpl; 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Siehe auch SPSinh und SPCosh 


fr P l = SPExp(ffp2); 

Ermittelt den Wert von e hoch einer FFP-Zahl. 

ffp2 -> FFP-Zahl, mit der e potenziert werden 

soll. 

ffpl -> Ergebnis von e hoch ffp2. 

FLOAT ffp2; 

FLOAT ffpl; 

e ist gleich 2,718281828459045. 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Siehe auch SPLog 


ffpl = SPLog(ffp2); 

Ermittelt den natürlichen Logarithmus einer FFP-Zahl. 

ffp2 -> FFP-Zahl, deren natürlicher Logarith¬ 

mus ermittelt werden soll. 

ffpl -> enthält den natürlichen Logarithmus 

von ffp2. 

FLOAT ffp2; 

FLOAT ffpl; 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Siche auch SPExp und SPLoglO 




326 Mathematik-Libraries 


15.2.13 SPLoglO 

Syntax: 

ffpl = SPLoglO(ffp2); 

Funktion: 

Ermittelt den lOer-Logarithmus einer FFP-Zahl. 

Parameter: 

ffp2 -> FFP-Zahl, deren Logarithmus zur 

Basis 10 ermittelt werden soll. 

Ergebnis: 

ffpl -> enthält den Logarithmus zur Basis 10 

von ffp2. 

Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 

Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: 

Siehe auch SPLog 

15.2.14 SPPow 

Syntax: 

ffpl = SPPow(ffp2, ffp3); 

Funktion: 

Ermittelt den Wert einer FFP-Zahl hoch einer weiteren FFP- 
Zahl. 

Parameter: 

ffp2 - > Basis der Potenzierung. 

ffp3 -> Potenz, in die die Basis gehoben wer¬ 

den soll. 

Ergebnis: 

ffpl - > Ergebnis der Potenzierung. 

Datentyp: 

FLOAT ffp2, ffp3; 

FLOAT ffpl; 

Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 
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15.2.15 SPSqrt 

Syntax: 

ffpl = SPSqrt(ffp2); 

Funktion: 

Ermittelt die Quadratwurzel einer FFP-Zahl. 

Parameter: 

ffp2 - > FFP-Zahl, aus der die Wurzel gezogen 

werden soll. 

Ergebnis: 

ffpl -> Quadratwurzel der FFP-Zahl. 

Datentyp: 

FLOAT ffp2; 

FLOAT ffpl; 

Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

15.2.16 SPTieee 

Syntax: 

int = SPTieee(ffp); 

Funktion: 

Wandelt eine FFP-Zahl in eine IEEE-Zahl um. 

Parameter: 

ffp - > FFP-Zahl, die gewandelt werden soll. 

Ergebnis: 

int -> IEEE-Zahl. 

Datentyp: 

FLOAT ffp; 
int int; 

Sonstiges: 

Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 
Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: 

Siehe auch SPFieee 

15.2.17 SPFieee 

Syntax: 

ffp = SPFieee(int); 

Funktion: 

Wandelt eine IEEE-Zahl in eine FFP-Zahl um. 

Parameter: 

int -> IEEE-Zahl, die umgewandelt werden 

soll. 

Ergebnis: 

ffp -> FFP-Zahl. 

Datentyp: 

int int; 

FLOAT ffp; 
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Sonstiges: Es ist zu beachten, daß die FFP-Zahl bei dem Lattice-C- 

Compiler in einer anderen Weise bereitgestellt werden muß. 
Siehe dazu Kapitel 15. 

Referenz: Siehe auch SPTieee 

1 /**t**************************** 

2 

3 Mathf fp-Demonstration 

4 last update 26/05/87 

5 van Joerg Koch und Frank Kremser 

6 (c> Markt & Technik 1987 

7 

8 ******************************** 

9 

10 Fuehrt alle Befehle aus, die die Mathematik-Bibliothek Mathtrans 

11 enthaelt. 

12 

13 ***#***************************/ 

14 

15 #include <exec/types.h> /# Include-Files laden */ 

16 ttinclude <exec/tasks.h> 

17 #include <exec/libraries.h> 

18 #include <exec/devices.h> 

19 #include <devices/keymap.h> 

20 #include <graphics/copper.h> 

21 ttinclude <graphics/display.h> 

22 #include <graphics/gfxbase.h> 

23 #include <graphics/text.h> 

24 #include <graphics/view.h> 

25 #include <graphics/gels.h> 

26 #include <graphics/regions.h> 

27 #include <graphics/sprite.h> 

28 #include <hardware/blit.h> 

29 #include <intuition/intuitian.h> 

30 #include <intuition/intuitionbase.h> 

31 #include <math.h> 

32 

33 extern int SPAtan(>; /# Nur fuer Lattice-C Benutzer notwendig #/ 

34 extern int SPSinO; 

35 extern int SPCosO; 

36 extern int SPTanO; 

37 extern int SPSincosC); 

38 extern int SPSinhO; 

39 extern int SPCosh(); 

40 extern int 5PTanh<); 

41 extern int SFExp(); 

42 extern int SPLog(); 

43 extern int SPPow<); 

44 extern int SF > 5qrt<); 

45 extern int SPTieee(>; 

46 extern int SFFieeeC); 

47 

48 int MathBase; /% Lib - Zeiger #/ 

49 int MathTransBase; 

50 

51 ergebnis(zahl) 

52 int zahl; 

53 < 

54 unian test 

55 C 


/# Ergebnis in Float-Zahl wandeln und */ 
/# ausgeben %/ 
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56 FLOAT f; 

57 int i; 

58 ) z; 

59 

60 z.i = SPTieee<zahl); 

61 printf <"/Cf",z.f); 

62 print-f < "\n" >; 

63 > 

64 

65 main() 

66 < 

67 union testl 

68 < 

69 FLOAT f 1; 

70 int il; 

71 > zahl 1; 

72 

73 union test2 

74 < 

75 FLOAT 42 ; 

76 int i2; 

77 > zahl2; 

78 

79 /% Libs oe-f-fnen */ 

80 i-f ((MathBase = OpenLibrary("mathffp.1ibrary", 0)) = 0) exit(); 

81 

82 i-f ((MathTransBase = OpenLibrary<"mathtrans.1ibrary", 0)) == 0) exit(); 

83 

84 zahl 1.fl = 0.2; 

85 zahll.il = SPFieee(zahl1.il); 

86 zahl2.i2 = SPSqrt(zahl 1.il); 

87 printf("Wurzel aus 0.2 ist"); 

88 ergebnis(zahl2.i2); 

89 

90 zahl 1.fl = 0.2; 

91 zahll.il = SF l Fieee< zahl 1 .il); 

92 zahl2.i2 = SPAtan(zahl 1.il>; 

93 printf("Arcustangens von 0.2 ist"); 

94 ergebnis(zahl2.i2); 

95 

96 zahl 1.fl = 0.2; 

97 zahll.il = SPFieee(zahl 1.il); 

98 zahl2.i2 = SPSin(zahl 1.il>; 

99 printf("Sinus von 0.2 ist"); 

100 ergehn is( zahl2.i2); 

101 

102 zahl 1.fl = 0.2; 

103 zahll.il = SPFieee(zahl 1.il); 

104 zahl2.i2 = SFCosCzahl 1.il); 

105 printf("Cosinus von 0.2 ist"); 

106 ergebnis(zahl2.i2); 

107 

108 zahl 1.f1 = 0.2; 

109 zahll.il = SFFieee(zahl 1.i1); 

110 zahl2.i2 = SPSinht zahll.il); 

111 printf("Hyperbolik-Sinus von 0.2 ist"); 

112 ergebnis(zahl2.i2); 

113 

114 zahl 1.fl = 0.2; 

115 zahll.il = SPFieee(zahl1.il); 

116 zahl2.i2 = SPCoshCzahl 1.i1>; 

117 printf<"Hyperboiik-Cosinus van 0.2 ist"); 

118 ergebnis(zahl2.i2); 
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119 

120 zahl 1 . + 1 = 0.2; 

121 zahll.il = SPFieee(zahl 1.il); 

122 zahl2.i2 = SPTanh(zahl 1.il); 

123 printf("Hyperboiik-Tangens von 0.2 ist"); 

124 ergebnis<zahl2.i2>; 

125 

126 zahl 1.fl = 0.2; 

127 zahll.il = SPFieee(zahl 1.il); 

128 zahl2.i2 = SPExp(zahl 1.il); 

129 printf("e hoch 0.2 ist"); 

130 ergebnis(zahl2.i2); 

131 

132 zahl 1.fl = 0.2; 

133 zahll.il = SPFieee(zahll.il); 

134 zahl2.i2 = SPLog(zahl 1.i1); 

135 printf("nat. Logarithmus von 0.2 ist"); 

136 ergehnis(zahl2.i2); 

137 

138 zahl 1.fl = 0.2; 

139 zahl 1 .i 1 = SPFieee(zahll.il); 

140 zahl2.i2 = SPPow(zahl1.il,zahl1.il); 

141 printf("0.2 hoch 0.2 ist"); 

142 ergebnis(zahl2.i2); 

143 

144 CloseLibrary(MathTransBase); /* Libs schliessen */ 

145 CloseLibrary(MathBase); 

146 > 
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Das IFF-Bild-Format 


Bei Rechnern früherer Generationen bestand oft die Schwierigkeit, Daten 
von einem Rechner zu einem anderen Rechner zu übertragen, denn die 
Bilddaten waren oftmals nicht kompatibel zueinander. Zeichenprogramme 
konnten oft das Format eines anderen Zeichenprogramms nicht lesen. Mit 
der Einführung des Amiga sollte diesem Chaos endlich ein Ende gemacht 
werden. Electronic Arts und Commodore-Amiga entwickelten ein Stan¬ 
dardformat, das IFF-Interchange-File-Format. Mit diesem Standard ist der 
Austausch von standardisierten Daten ohne Schwierigkeiten möglich. In die¬ 
sem Kapitel wollen wir jedoch nur auf den IFF-Bildstandard eingehen. 

Commodore-Amiga empfiehlt jedem Programmierer, sich an diesen Stan¬ 
dard zu halten. Möchte man problemlos Bilder, die mit DeluxePaint, 
Graphicraft oder einem anderen Malprogramm erstellt wurden, in eigenen 
Programmen verwenden, so muß man sich diesem Standard anpassen oder 
die fertigen Bilder konvertieren und in einem eigenen Format abspeichern, 
wie wir es in Kapitel 10 »Ein- und Ausgabe« praktiziert haben. Dies ist sehr 
umständlich, da z.B. unserer Konvertierungsprogramm in Basic geschrieben 
ist und getrennt geladen werden muß. Also bleibt einem nichts anderes übrig, 
als mit der IFF-Welle zu schwimmen. 

Der Aufbau dieser IFF-Bild-Files scheint zunächst sehr komplex zu sein, 
wenn Sie mal unsere IFF-Read- und IFF-Write-Listings betrachten. Zum 
IFF-Read-Programm sei an dieser Stelle gesagt, daß keine DeluxePaint-Bil- 
der direkt geladen werden können, da diese zusätzlich komprimiert sind. 
Diese Bilder müssen zunächst mit Graphicraft geladen und abgespeichert 
werden. Umgekehrt, beim Abspeichern der Bild-Daten im IFF-Format mit 
dem IFF-Write-Programm bestehen keine Schwierigkeiten, da diese Daten 
sowohl mit DeluxePaint, als auch, wenn das Bildformat nicht größer als 320 x 
200 ist, mit Graphicraft geladen und weiterverarbeitet werden können. Die 
Daten, um fließende Farbanimation darzustellen, haben wir beim Speichern 
und Lesen nicht berücksichtigt. 
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Das Standard-Format besteht aus einzelnen Teilen, die durch einen 4-stelli- 
gen Titel angezeigt werden. Nach jedem Titel folgt eine bestimmte Anzahl 
Daten, woraus der Programmier z.B. die Größe der BitMaps erkennen kann. 
Die Daten innerhalb dieser Teile haben eine festgelegte Reihenfolge, 
wodurch das Auffinden von bestimmten Parametern stark vereinfacht wird. 
Die Titel, die ein IFF-Bild enthalten kann, sind: 

Zu Beginn stehen folgende Einträge: 

FORM- Kopf des IFF-Flles, enthält die Länge der Datei. 

ILBM- Kopf, der den Beginn der nachfolgenden Daten kenn 

zeichnet. 


Im Anschluß daran stehen die folgenden Daten in der Datei. Die ist aber 
nicht zwangsläufig so. Da nicht alle Daten unbedingt mitgespeichert werden 
müssen, können einige fehlen oder aber mehrmals auftreten. Zudem besteht 
keine festgelegte Reihenfolge. Allein »BODY« und die zugehörigen Bild¬ 
daten müssen am Ende der Datei stehen. 


DPPV - 

BMHD- (BitMapHeader) 
CMHD- 


CMAP- (ColorMap) 
CRNG- (ColorRange) 
BODY- 
CAMG- 


CCRT- (Cyclelnfo) 


Graphicraft-spezifisch. 
Grafikinformation. 
Graphicraft-spezifl sch. 

Färb Informationen. 

Informationen zu Farbverläufen. 
Bilddaten der Grafik. 
Amiga-spezlflsch: VievPort-Mode 
Informationen zur Farbanimation. 


des Screens. 


Wie schon erwähnt, folgen diesen Titeln Daten in einer gewissen Reihen¬ 
folge, so daß man nicht alle Titel abfragen muß, um an bestimmte Parameter 
zu gelangen. Wichtig sind CMAP, BODY, BMHD und FORM, da sie die 
Grundinformationen der Grafik enthalten: 

Kopf: 

vier Bytes: "FORM" 

vier Bytes: Größe der Datei in Bytes. 

vier Bytes: "ILBM" 


BitMapHeader: 

vier Bytes: 
vier Bytes: 
zwei Bytes: 
zwei Bytes: 
vier Bytes: 
ein Byte: 
fünf Bytes: 
ein Byte: 


"BMHD" 

Wert 20 als LONGCARD (Länge von BMHD) 
Breite des Screens 
Höhe des Screens 
WertO 

Tiefe des Screens 

WertO 

Wert 10 
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ein Byte: 
zwei Bytes: 
zwei Bytes: 

Wert 11 

Breite des Screens 

Höhe des Screens 

ColorMap: 


vier Bytes: 

"CMAP" 

vier Bytes: 

Anzahl der Farben mal 3 

anschließend: 

für jede Farbe je 3 Bytes (Rot, Grün, Blau werden 
getrennt gespeichert) 


Body: 

vier Bytes: "BODY" 

vier Bytes: Größe der Grafik = Höhe * Breite / 8 * Tiefe 

anschließend: Grafik, reihenweise gespeichert. Also: erste Zeile 

von erster BilPlane, dann erste Zeile von zweiter 
BitPlane usw. 

Die Art dieses Aufbaus können Sie auch erkennen, wenn Sie ein Bildfile mit 
»type opt h" vom CLI aus listen. Diese Grundstruktur wird sowohl beim La¬ 
den als auch beim Speichern von IFF-Bild-Files verwendet. 
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1 /*#***####*#******************** 

2 

3 IFF-Read-Demonstration 

4 last update 26/05/87 

5 von Frank Kremser und Joerg Koch 

6 (c) Markt & Technik 1987 

7 

8 ******************************** 

9 

10 Diese laedt ein Bild im IFF-Format ein. Der Screen passt sich automatisch 

11 dem Bildformat an. DPaint Bilder muessen erst Graphicraft konvertiert 

12 werden, da diese Bilder komprimiert sind. 

13 

14 ******************************/ 

15 

16 ttinclude <exec/types.h> /* Include-Files laden */ 

17 ttinclude <exec/tasks.h> 

18 #include <exec/libraries.h> 

19 #include <exec/devices.h> 

20 ttinclude <exec/memory.h> 

21 #include <devices/keymap.h> 

22 ttinclude <graphics/copper.h> 

23 ttinclude <graphics/display.h> 

24 ttinclude <graphics/gfxbase.h> 

25 ttinclude <graphics/text.h> 

26 ttinclude <graphics/view.h> 

27 ttinclude <graphics/gels.h> 

28 ttinclude <graphics/regions.h> 

29 ttinclude <graphics/sprite.h> 

30 ttinclude <hardware/blit.h> 

31 ttinclude <libraries/dos.h> 

32 ttinclude <intuition/mtuition.h> 

33 ttinclude <intuition/intuitionbase.h> 

34 

35 

36 struct IntuitionBase *Intui tionBase; /* Lib - Zeiger */ 

37 struct GfxBase «GfxBase; 

38 ULGNG DosBase; 

39 

40 BYTE *pufferC53; /# max 5 BitPlane-Zeiger */ 


41 

42 

char dppvC] = 

f"DPPV"> 

43 

char bmhdC] = 

( ,, BMHD ,, > 

44 

char cmapC] = 


45 

char cmgC ] = 

{"CRNG"> 

46 

char bodyC] = 

{•'BODY") 

47 

char camgC3 = 

{"CAMG"> 

48 

char ccrtC] = 

{"CCRT ,, > 

49 

50 

struct Screen 

«screen; 

51 

52 

struct NewScreen ns = 

53 

< 


54 

o, 


55 

0, 


56 

o, 


57 

0, 


58 

0, 


59 

o, 


60 

1. 


61 

NULL, 


62 

CUST0MSCREEN, 

63 

NULL, 


64 

NULL, 



/* IFF Titel */ 


/* Screen definieren */ 

/* wird spaeter konfiguriert */ 
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65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 
81 
82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101 
102 

103 

104 

105 

106 

107 

108 

109 

110 
111 
112 

113 

114 

115 

116 

117 

118 

119 

120 
121 
122 

123 

124 

125 

126 

127 

128 


NULL, 
NULL 
>; 


main() 

( 

LQNG schleife, schleif, fanz; 
ULGNG datei, mull; 

BYTE rot, grün, blau; 
char textC3D; 

B00L ende; 

struct RastPort #rp; 
struct BitMap *ptr; 


if ((GfxBase = (struct GfxBase *) 

OpenLibrary( "graphics. library'*, 0)) —0) exit(); 


if ((IntuitionBase = (struct IntuitionBase *) 

OpenLibrary("Intuition.library" , 0)) =0) exit(); 

/* Libs oeffnen */ 

if ((DosBase = 

GpenLibrary("dos.1ibrary", 0)) =0) exit(); 

datei = Open("DFO:IFFBILD",MODE_0LDFILE); /* Datei oeffnen */ 

if(datei = 0) /* Filename: Iffbild */ 

{ 

prmtf( "Keinen File geoefnet !!\n">; 
exit(>; 

>; 


mull = AllocMem(25,MENF_CHIP:MEhF_CLEAR); /* Muel1-Speicher */ 

ende = FALSE; 

Read(datei,mul 1,12); /* Header laden */ 


while(ende — FALSE) 

{ 

Read(datei,&textC03,4); 

if<strncmp(&textC03,&bmhdC0],4) == 0) /* BMHD laden */ 

( 

Read(datei,mul1,4); 

Read(datei,&ns.Width,2>; 

Read(datei,&ns.Height,2); 

Read(datei,mul1,3); 

Read(datei,&ns.Depth,2); 

Read(datei,mul1,11); 

if(ns.Width > 320) ns.ViewModes != HIRES; 
if(ns.Height > 256) ns.VitW y todes .’= INTERLACE; 


/* Screen oeffnen %/ 

if ((screen = (struct Screen*) OpenScreen(&ns)) == NU_L) exitO; 


rp = &screen->RastPort; /* BitMapPointer bestimmen 

ptr = rp-^BitMap; 

for(schleife = 0; schleife < ns.Depth; schleife++) 
pufferCschleifeJ = ptr->PlanesCschleifel; 


>; 


/* Cm 3 laden */ 

if(strncmp(&textC03,&cmapC01,4) == 0) 


< 


Read(datei,&fanz,4); 
fanz = fanz / 3; 


*/ 
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129 

for(schleife = 0; schleife < fanz; 

schleife++) 

130 

i 


131 

Read(datei f &rot,1); 


132 

Read(datei,&grun,1); 


133 

Read<datei,&blau,1); 


134 

SetRGB4(&screen->ViewPort»schleife,rot/16,grun/16,blau/16); 

135 

>; 


136 

>; 


137 

/* BODY 

laden #/ 

138 

if(strncmp(&text[03,&body[0J,4) — 0) 


139 

< 


140 

Read(datei,mul1,4); 


141 

for(schleif = 0; schleif < ns.Height; schleif++) 

142 

for(schleife = 0; schleife < ns. 

Depth; schleife++) 

143 

Read(datei,puffertschleife] + 

(ns.Width / 8 * schleif), 

144 


ns.Width / 8) 

145 

ende = TRUE; 


146 

>; 


147 



148 

if (stmcmp(&textC03 ,&cmg[03,4) == 0) 

/# Zusatzinformationen */ 

149 

Read(datei,mul1,12); 

/% uebergehen, falls #/ 

150 


/* vorhanden #/ 

151 

if (stmcmp(&textC0] ,&dppv[03,4) = 0) 


152 

Read(datei,mu11,108); 


153 



154 

if (stmcmp<&textC0] ,&camgC0] ,4) = 0) 


155 

Read(datei,mul1,8); 


156 



157 

if (stmcmp(&textC0],&ccrtC03,4) == 0) 


158 

Read(datei,mul1,18); 


159 

>; 


160 



161 

Close(datei); 

/* Datei schliessen */ 

162 



163 

for(schleife = 0; schleife < 750000; ++schleife); 

164 



165 

CloseScreen(screen); 

/* Screen und Libs %/ 

166 

CloseLibrary(DosBase); 

/* schliessen */ 

167 

CloseLibrary(IntuitionBase); 


168 

CloseLibrary(Gfxöase); 


169 

> 



1 /******************************* 

2 

3 IFF-Write-Demonstration 

4 last update 26/05/87 

5 von Joerg Koch und Frank Kremser 

6 (c) Markt & Technik 1987 

7 

8 ******************************** 

9 

10 Dieses Programm oeffnet einen Screen und speichert ihn als IFF- 

11 File ab. 

12 

13 *******************************/ 

14 

15 #include <exec/types.h> /* Include-Files laden */ 

16 #include <exec/tasks.h> 

17 #include <exec/1ibraries.h> 

18 #include <exec/devices.h> 

19 #include <exec/memory.h> 

20 #include <devices/keymap.h> 
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21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 
81 
82 
83 


»include 
#include 
#ine lüde 
#include 
»include 
»include 
»include 
»include 
»include 
»include 
»include 
»include 


<graphics/copper.h> 
<graphics/display.h> 
<graphics/gfxbase.h> 
<graphics/tex t.h> 
<graphics/view.h> 
<graphics/ge1 s. h> 
<graphics/regions.h> 
<graphics/sprite.h> 

< hardware/b1it.h> 

<1ibraries/dos.h> 

<intuition/intuition.h> 

<intuition/intuitionbase.h> 


struct IntuitionBase *IntuitionBase; /* Lib - Zeiger */ 
struct GfxBase *GfxBase; 

ULGNG DosBase; 


BYTE 

#pufferC53; 

char 

formC 3 

s 

{"FORM"> 

char 

ilbmC 3 

= 

("ILBM“> 

char 

dppvC 1 

= 

{“DPPV"> 

char 

bmhdC D 

= 

("BMHD"> 

char 

cmapC] 

= 


char 

crngC D 

= 

{"CRNG”) 

char 

bodyC3 

= 

{"BODY”> 

char 

camgC] 

= 


char 

ccrtC] 

= 

("CCRT"} 

struct Screen 

♦screen; 


max 5 Puffer-Zeiger #/ 
/* IFF-Titel */ 


struct NewScreen ns = /* Screen definieren #/ 

( 

0 , 

o, 

320, 

256, 

5, 

0 , 

1 , 

NULL, 

CUSTOMSCREEN, 

NULL, 

NULL, 

NULL, 

NULL 

>; 


main() 

< 

LONG schleife, schleif, fanz; 
ULGNG datei, dat; 

WORD färbe; 

BYTE rot, grün, blau, dati; 
struct RastPort *rp; 
struct BitMap #ptr; 


f ((GfxBase = (struct GfxBase *) 

□penLibrary("graphics.1lbrary" , 0)) =0) exit() 
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84 if t (IntuitionBase = (struct IntuitionBase *> 


85 

0penLibrary("intuition.library", 0)) =0) exit(); 

86 


/* Libs oeffnen 

87 

lf ((DosBase = 


88 

0penLibrary("dos.library", 0)) =0) exit(); 


89 



90 

datei = 0pen( "DF0:DEM0SCREEN" ,MÜDE_NEl*FILE); 

/* Datei oeffnen */ 

91 

if(datei == 0) 

/* IFF-File wird */ 

92 

{ 

/* als */ 

93 

pnntf ( "Keinen File geoefnet \n"); 

/*Demoscreen */ 

94 

exit(); 

/* abgespeichert */ 

95 

>; 


96 

/% Screen oeffnen */ 


97 

lf ((screen = (struct Screen*) OpenScreen(&ns)> 

= NULL) exit(); 

98 



99 

fanz = 1; 


100 

rp = &screer\->RastPort; /* BitPlane-Zeiger ermitteln */ 

101 

ptr - rp->BitMap; 



102 forlschleife = 0; schleife < ns.Depth; schleife++) 

103 { 

104 puffert schlei fei = ptr->PlanesCschleifel; 

105 fanz = fanz * 2; 

106 >; 

107 /* Header schreiben */ 

108 Write(datei,&formC0D,4); 

109 dat = 48 + (fanz * 3) + (ns.Width / 8 * ns.Height * ns.Depth); 

110 Write(datei,&dat,4); 

111 Write(datei,&ilbmC0D,4); 

112 

113 Write(datei,&bmhdC0D,4); /* BMHD schreiben */ 

114 dat = 20; 

115 Write(datei,&dat,4); 

116 Write(datei,&ns.Width,2); 

117 Write(datei,&ns.Height,2); 

118 dat = 0; 

119 Write(datei,&dat,4); 

120 dati = (BYTE) ns.Depth; 

121 Write(datei,&dati,1); 

122 Write(datei,&dat,1); 

123 Write(datei,&dat,4); 

124 dati = 10; 

125 Write(datei,&dati,1); 

126 dati =11; 

127 Wnte(datei ,&dati , 1); 

128 Write(datei,&ns.Width,2); 

129 Write(datei,&ns.Height,2); 

130 

131 Write(datei,&cmapCOD,4); /% CMAP schreiben #/ 

132 fanz = fanz * 3; 

133 Write(datei,&fanz,4); 

134 fanz = fanz / 3; 

135 for(schleife = 0; schleife < fanz; schleife++) 

136 < 

137 färbe = GetRGB4(screen->ViewPort.ColorMap,schleife); 

138 rot = färbe / 256; 

139 rot = rot # 16; 

140 färbe = färbe - (rot * 16); /* Farben berechnen */ 

141 grün = färbe / 16; 

142 grün = grün * 16; 

143 färbe = färbe - grün; 

144 blau = färbe % 16; 

145 Write(datei,&rot,1); 

146 Write(datei,&grun,1); 

147 Write(datei,&blau,1); 
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148 >; 

149 /% BODY schreiben %/ 

150 Write(datei,&bodyC03,4); 

151 dat = ns.Width / 0 * ns.Height * ns.Depth; 

152 Write(datei,&dat,4); 

153 fortschleif = 0; schleif < ns.Height; schleif++> 

154 for(schleife = 0; schleife < ns.Depth; schleife++) 

155 Write(datei,pufferCschleife] + (ns.Width / 8 * schleif), 

156 ns.Width / 8); 

157 

158 Close(datei); /% File schliessen */ 

159 

160 for(schleife = 0; schleife < 20000; ++schleife); 

161 

162 CloseScreen(screen); /% Libs und 5creen schliessen */ 

163 CIoseLlbrary(DosBase); 

164 CloseLibrary(IntuitionBase); 

165 CloseLibrary(GfxBase); 

166 > 
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17 


Sonstige Befehle 


In diesem Kapitel werden Befehle erläutert, die nicht in die vorherigen 
Kapitel eingeordnet werden konnten, aber trotzdem wichtige Funktionen 
erfüllen. 

Da diese Befehle allerdings zu unterschiedlich sind, kann für dieses Kapitel 
ausnahmsweise kein Demonstrationsprogramm angeführt werden. Da die 
Befehle aber recht einfache Funktionen erfüllen, glauben wir, daß dies kein 
allzugroßer Nachteil ist. 
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17.1 CurrentTime 


Syntax: 

Funktion: 

Parameter: 


Ergebnis: 

Datentyp: 

Sonstiges: 


CurrentTime(&Sekunden,&Mikrosek); 

Holt die Systemzeit. 

Sekunden -> Langwort-Variable, in der die Sekun¬ 

den der Systemzeit gespeichert werden 

Mikrosek -> Langwort-Variable, in der die Mikro¬ 

sekunden gespeichert werden 

Kein Ergebnis. 

LONG Sekunden, Mikrosek; 

Stunden und Minuten der Systemzeit müssen aus der Sekun¬ 
denzeit ermittelt werden. Da die Sekundenvariable 4 Bytes 
(Langwort) lang ist, kann sie Werte bis zu 2 hoch 32 Sekun¬ 
den, also etwa 139 Jahre, aufnehmen. 

Die Sekunden- und Mikrosekunden-Variablen werden fol¬ 
gendermaßen deklariert: 

LONG Sekunden, Mikrosek; 
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17.2 Doubleclick 

Syntax: 

gut = DoubleClick(SSckunden,SMikro,ESekunden,EMikro); 

Funktion: 

Prüft, ob ein Maus-Doppelklick in Ordnung war 

Parameter: 

SSekunden, 

SMikro -> Startzeit des Doppelklicks 


ESekunden, 

EMikro -> Endzeit des Doppelklicks 

Ergebnis: 

gut -> Ist TRUE, falls er in Ordnung war, 

FALSE, falls nicht 

Datentyp: 

LONG SSekunden, SMikro, ESekunden, EMikro; 

Sonstiges: 

Die Start- und Endzeiten können mittels CurrentTime 
ermittelt werden. 


Anschließend vergleicht dieser Befehl die benötigte Zeit mit 
der erlaubten Zeit, die mit Preference festgelegt ist. War sie 
zu lang, wird FALSE zurückgegeben, das heißt, daß dies kein 
erlaubter Doppelklick war. War er erlaubt, wird TRUE 
zurückgegeben. 
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Anhang A 


Zuweisungen Befehle < - > 

Libraries 


Aus der folgenden Liste kann abgelesen werden, welche Libraries mit 

»#include« einzulesen sind, um bestimmte Befehle verwenden zu können: 

clist.library AllocCList 

ConcatCList 
CopyCList 
FlushCList 
FreeCList 
GetCLBuf 
GetCLChar 
GetCLWord 
IncrCLMark 
InitCLPool 
MarkCList 
PeekCLMark 
PutCLBuf 
PutCLChar 
PutCLWord 
SizeCList 
SplitCList 
SubCList 
UnGetCLChar 
UnGetCLWord 
UnPutCLChar 
UnPutCLWord 
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dos.Iibrary 


Close 

CreateDir 

CreateProc 

CurrentDir 

DateStamp 

Delay 

DeleteFile 

DeviceProc 

DupLock 

Examine 

Execute 

Exit 

ExNext 

Info 

Input 

IoErr 

Islnteractive 

LoadSeg 

Lock 

Open 

Output 

ParentDir 

Read 

Rename 

Seek 

SetComment 

SetProtection 

UnLoadSeg 

UnLock 

WailForChar 

Write 


diskfont.library 


AvailFonts 

OpenDiskFont 
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exec.library 


AddDevice 

AddHead 

AddlntServer 

AddLibrary 

AddPort 

AddResource 

AddTail 

AddTask 

Alert 

Allocat 

AllocEntry 

AllocMem 

AllocSignal 

AllocTrap 

AvailMem 

Cause 

ChecklO 

CloseDevice 

CloseLibrary 

ColdReset 

Deallocate 

Disable 

DoIO 

Enable 

Enqueue 

FindName 

FindPort 

FindTask 

Forbid 

FreeEntry 

FreeMem 

FreeSignal 

FreeTrap 

GctCC 

GetMsg 

InitStruct 

Insert 

MakeLibrary 

OpenDevice 

OpenLibrary 

OpenResource 

Permit 

PutMsg 
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exec_support.library 


graphics.library 


RemDevice 

RemHead 

RemlntServer 

RemLibrary 

Remove 

RemPort 

RemResource 

RemTail 

RemTask 

ReplyMsg 

SendIO 

SetExcept 

SetFunction 

SetlntVector 

SelSignal 

SctSR 

SetTaskPri 

Signal 

SumLibrary 

SuperState 

UserState 

Wait 

WaitIO 

WailPort 

CreateExtIO 

CreateStdlO 

DcletcPort 

DclcteStdlO 

AddAnimOb 

AddBob 

AddFont 

AddVSprite 

AllocRaster 

AndRectRegion 

AndRegionRegion 

Animate 

AreaDraw 

AreaEnd 

AreaMove 

AskFont 

AskSoftStylc 

BliBitMap 
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BltBitMapRastPort 

BltClear 

BltPattern 

BltTemplate 

CEND 

ChangeSprite 

CINIT 

ClearEOL 

ClearRegion 

ClearScreen 

ClipBlit 

CloseFont 

CMOVE 

CopySBitMap 

CWAIT 

DisownBlitter 

DisposeRegion 

DoCollision 

Draw 

DrawGList 

Flood 

FreeColorMap 

FreeCopList 

FreeCprList 

FrceGBuffers 

FreeRaster 

FreeSprite 

FreeVPortCopLists 

GetColorMap 

GetGBuffers 

GetRGB4 

GetSprite 

InitArea 

InitBitMap 

InitGels 

InitGMasks 

InitMasks 

InitRastPort 

InitTmpRas 

InitView 

InitVPort 

LoadRGB4 

LoadView 
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LockLayerRom 

MakeVPort 

Move 

MoveSprite 

MrgCop 

NewRegion 

OpenFont 

OrRectRegion 

OrRegionRegion 

OwnBlitter 

PolyDraw 

QBlit 

QBSBlit 

ReadPixel 

RectFill 

RemFont 

RemIBob 

RemVSprite 

ScrollRaster 

ScrollVPort 

SetAPen 

SetBPen 

SetOPen 

SetColiision 

SctDrMd 

SctFont 

SetRast 

SetRGB4 

SetSoftStyle 

SortGList 

SyncSBitMap 

Text 

TextLength 

UnlockLayerRom 

VBeamPos 

WaitBlit 

WaitBOVP 

WaitTOF 

WritePixcl 

XorRectRegion 

XorRegionRegion 

icon AddFreeList 

AllocWBObject 
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BumpRevision 

FindToolType 

FreeDiskObject 

FreeFreeList 

FreeWBObject 

GetDiskObject 

Getlcon 

GetWBObject 

MatchToolValue 

PutDiskObject 

Puticon 

PutWBObject 

intuition.library AddGadget 

AllocRemember 

AutoRequest 

BeginRefresh 

BuildSysRequest 

ClearDMRequest 

ClearMenuStrip 

ClearPointer 

CloseScreen 

CloseWindow 

CloseWorkBench 

CurrentTime 

DisplayAlert 

DisplayBeep 

Doubleclick 

DrawBorder 

Drawlmage 

EndRefresh 

EndRequest 

FreeRemember 

FreeSysRequest 

GetDcfPrefs 

GetPrcfs 

InitRequester 

IntuiTextLength 

ItemAddress 

MakeScrecn 

ModifylDCMP 

ModifyProp 

MoveScreen 

MoveWindow 
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layers.library 


OffGadget 

OffMenu 

OnGadget 

OnMenu 

OpenScreen 

OpenWindow 

OpenWorkBench 

PrintIText 

RefreshGadgets 

RemakeDisplay 

RemoveGadget 

ReportMouse 

Request 

RethinkDisplay 

ScreenToBack 

ScreenToFront 

SetDMRequest 

SetMcnuStrip 

SetPointer 

SetPrefs 

SetWindowTitels 

ShowTitle 

SizeWindow 

ViewAddress 

ViewPortAddress 

WBenchToBack 

WBenchToFront 

WindowLimits 

WindowToBack 

WindowToFront 

BeginUpdate 

BehindLayer 

CreateBehindLayer 

CreateUpfrontLayer 

DeleteLayer 

DisposeLayerlnfo 

EndUpdate 

FaltenLayerlnfo 

InitLayers 

LockLayer 

LockLayerlnfo 

LockLayers 

MoveLaycr 
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mathffp.library 


mathtrans.library 


MoveLayerlnFrontOf 

NewLayerlnfo 

ScrollLayer 

SizeLayer 

SwapBitsRastPortClipRect 

ThinLayerlnfo 

UnlockLayer 

UnlockLayerlnfo 

UnlockLayers 

UpfrontLayer 

WhichLayer 

abs 

faddi 

fcmpi 

fdivi 

fflti 

fmuli 

fnegi 

fsubi 

ftsti 

SPAbs 

SPAdd 

SPCmp 

SPDiv 

SPFlt 

SPMul 

SPNcg 

SPSub 

SPTst 

SPAcos 

APAsin 

APAtan 

SPCos 

SPCosh 

SPExp 

SPFicce 

SPLog 

SPLoglO 

SPPow 

SPSin 

SPSincos 

SPSinh 
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SPSqrt 

SPTan 

SPTanh 

SPTieee 

mathieeedoubbas.library IEEEDPAbs 
IEEEDPAdd 
IEEEDPCmp 
IEEEDPDiv 
IEEEDPFlt 
IEEEDPMul 
IEEEDPNeg 
IEEEDPSub 
IEEEDPTst 

Nicht alle Befehle lassen sich in die obenstehenden Libraries einordnen. Ein 
Beispiel hierfür sind die Macros, wie OFF_SPRITE, ON_SPRlTE, 
OFF DISPLAY und ON DISPLAY. Sie befinden sich in einer Includc- 
Datei auf der C-Diskette. Soll solch ein Macro verwendet werden, so muß 
folgender Include-Befehl gegeben werden: 

/lnclude <graphics/gfxinacros.h>c 



Anhang B 
Die Structures 


Für die Programmierung des Amiga stehen noch weitaus mehr Structures 
bereit, als in den Kapiteln beschrieben werden konnte. Aus diesem Grund 
führen wir an dieser Stelle alle weiteren Structures an. 


Wie auf die einzelnen Einträge zugeriffen werden kann, wollen wir anhand 
eines kurzen Beispiels darstellen: 

Nehmen wir an, es gäbe folgende Structure: 


struct Demo 
{ 

USHORT elntrag; 
struct Demo amigaj 


>; 


/* Integer-Elntrag */ 

/* Dieser Eintrag besteht aus einer 
weiteren Structure vom Typ Demo »/ 


Dann könnte sie folgendermaßen deklariert werden: 

struct Demo test - oder struct Demo test - 

{ { 

254 , 765 , 

NULL viel 


h 


>; 


Die zweite Möglichkeit ist nur erlaubt, wenn zuvor eine Variable "viel" vom 
Typ Demo - also dem Structure-Typ - deklariert wurde. Sollen der 
Structure erst im Programm Werte übergeben werden, so genügt folgende 
Deklaration: 


struct Demo test; 


Sollen der Variablen »test« im Programm nun bestimmte Werte zugewiesen 
werden oder soll auf Eintragungen zugegriffen werden, so muß das folgen¬ 
dermaßen geschehen: 
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test.elntrag 

test.amiga, bzw. test.amiga.eintrag, bzw. test.amiga.amiga usu. 

Ist "test" als Zeiger deklariert worden, also 

struct Demo *test; 

so muß mit 

test->eintrag 
test->amlga usu 

darauf zugegriffen werden. 

Aber nun zu den Structures: 

struct AnimComp { 

WORD Flags; 

WORD Timer; 

WORD TlmeSet; 

struct AnimComp «NextComp; 
struct AnimComp «PrevComp; 
struct AnimComp »NextSeq; 
struct AnimComp »PrevSeq; 

WORD (»AnimCRoutine)(); 

WORD YTrans; 

WORD XTrans; 

struct AnlmOb *HeadOb; 

struct Bob »AnlmBob; 

}; 

struct AnlmOb { 

struct AnlmOb «NextOb, *PrevOb; 

LONG Clock; 

WORD AnOldY, AnOldX; 

WORD AnY, AnX; 

WORD YVel, XVel; 

WORD YAccel, XAccel; 

WORD RlngYTrans, RlngXTrans; 

WORD (»AnlmORoutlne)(); 
struct AnimComp «HeadComp; 

AUserStuff AUserExt; 

); 

struct BlltNode { 
struct BlltNode *n; 
lnt (*function)(); 
char stat; 
short beamsync; 
int (*cleanup)(); 

); 
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struct Bob { 

UORD Flags; 

UORD »SaveBuffer; 

WORD »ImageShadov; 
struct Bob »Before; 
struct Bob »After; 
struct VSprlte «BobVSprlte; 
struct AnimComp »BobComp; 
struct DBufPacket »DBuffer; 
BUserStuff BUseerExt; 

]; 


struct CllpRect { 

struct CllpRect »Next; 
struct CllpRect »Prev; 
struct Layer *lobs; 
struct BltMap »BltMap; 
struct Rectangle bounds; 
struct CllpRect *_p1, *_p2; 

LONG reserved; 

LONG flags; 

}; 

struct DBufPacket { 

WORD BufY, BufX; 
struct VSprlte »BufPath; 

WORD »BufBuffer; 

}; 

struct DiskFontHeader { 
struct Node dfh_DF; 

UWORD dfhFilelD; 

UWORD dfh_Revlslon; 

LONG dfh_Segoent; 

char dfh_Name[HAXFONTNAME]; 

struct TextFont dfh_TF; 

}; 

struct DlskObJect { 

UWORD do_Maglc; 

UWORD doj/ersion; 
struct Gadget do_Gadget; 

UBYTE do_Type; 
char *do_DefaultTool; 
char *»do_ToolTypes; 

LONG do_CurrentX; 

LONG do_CurrentY; 

struct DrauerData *do_DrawerData; 

char *do_ToolWlndou; 

LONG do_StackSlze; 

); 
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struct DraverData { 

struct NevUindov dd_NevUindov; 
LONG dd_CurrentX; 

LONG dd_CurrentY; 

LONG dd_MinX; 

LONG dd_HinY; 

LONG dd_HaxX; 

LONG ddJIaxY; 

struct Gadget dd_HorizScroll; 
struct Gadget dd_VertScroll; 
struct Gadget dd_UpMove; 
struct Gadget dd_DovnMove; 
struct Gadget dd_LeftMove; 
struct Gadget dd_RightMove; 
struct Image dd_HorizImage; 
struct Image dd_VertImage; 
struct Proplnfo dd_HorizProp; 
struct Proplnfo dd_VertProp; 
struct Hindow *dd_DrawerWin; 
struct UBObject *dd_Object; 
struct List dd_Children; 

LONG dd_Lock; 

); 


struct FontContents { 

char fc_FileName[MAXFONTPATH]; 
UUORD fc_YSize; 

UBYTE fc_Style; 

UBYTE fc_Flags; 

); 

struct FontContentsHeader { 

UWORD fch_FilelD; 

UUORD fch_NumEntries; 

}; 

struct Layer { 

struct Layer »front, »back; 
struct ClipRect »ClipRect; 
struct RastPort *rp; 
struct Rectangle bounds; 

UBYTE Lock; 

UBYTE LockCount; 

UBYTE'LayerLockCount; 

UBYTE reserved; 

UUORD reservedl; 

UUORD Flags; 

struct BitMap »SuperBitMap; 
struct ClipRect »SuperClipRect; 
APTR Uindou; 

SHORT ScrollJC, Scroll_Y; 
struct MsgPort LockPort; 
struct Message LockMessage; 
struct MsgPort ReplyPort; 
struct Message I_LockMessage; 
struct Region »DamageList; 
struct ClipRect *_cliprects; 
struct Layer_Info *Layer_Info; 
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struct Task »LayerLocker; 
struct ClipRect «SuperSaveClipRects; 
struct ClipRect "er, *cr2, »ernew; 
APTR _p1; 


struct Layer_Info { 

struct Layer *top_layer; 
struct Layer *check_lp; 
struct Layer *obs; 
struct MsgPort RP_ReplyPort; 
struct MsgPort LockPort; 

UBYTE Lock; 

UBYTE broadcast; 

UBYTE LockNest; 

UBYTE Flags; 
struct Task «Locker; 

BYTE fatten_count; 

UBYTE bytereserved; 

UWORD wordreserved; 

UWORD Layerinfo_extra_size; 

ULONG longreserved; 

struct LayerInfo_extra *LayerInfo_extra; 


struct Library { 

struct Node lib_Node; 
UBYTE llb_Flags; 

UBYTE 1lbpad; 

UWORD libNegSize; 

UWORD lib_PosSize; 

UWORD lib_Verslon; 

UWORD lib_Revlsion; 

APTR llb_IDStrlng; 

ULONG lib_Sum; 

UWORD lib_OpenCnt; 

}; 

struct List { 

struct Node *Ih_Head; 
struct Node *Ih_Tail; 
struct Node *Ih_TailPred; 
UBYTE Ih_Type; 

UBYTE l_pad; 

); 


struct MemHeader { 
struct Node mh_Node; 

UWORD mh_Attributes; 
struct MemChunk *mh_Flrst; 
APTR mh_Lover; 

APTR mhJJpper; 

ULONG nh_Free; 

}; 
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struct Message { 

struct Node nm_Node; 
struct MsgPort »mn_ReplyPort; 
UWORD mn_Length; 


struct MsgPort { 

struct Node mp_Node; 
UBYTE mp_Flags; 

UBYTE mp_S1gBit; 
struct Task »mp_SigTask; 
struct List mp_MsgLlst; 


struct NeuScreen { 

SHORT LeftEdge, TopEdge; 
SHORT Width, Height; 

UBYTE DetailPen, BlockPen; 
USHORT VieuModes; 

USHORT Type; 

struct TextAttr »Font; 

UBYTE »DefaultTitle; 
struct Gadget »Gadgets; 
struct BitMap »CustomBitMap; 


struct NevWindov { 

SHORT LeftEdge, TopEdge; 

SHORT Width, Height; 

UBYTE DetailPen, BlockPen; 

ULONG IDCMPFlags; 

ULONG Flags; 

struct Gadget »FirstGadget; 
struct Image »CheckMark; 

UBYTE »Title; 
struct Screen »Screen; 
struct BitMap »BitMap; 

SHORT MlnWidth, MinHelght; 

SHORT MaxUidth, MaxHeight; 

USHORT Type; 

}; 

struct Node { 

struct Node »In_Succ; 
struct Node »In_Pred; 

UBYTE In_Type; 

BYTE In_Pri; 
char *In_Name; 

}; 

struct Preferences ( 

BYTE FontHeight; 

UBYTE Printerport; 

USHORT BaudRate; 

struct tlmeval KeyRptSpeed, KeyRptDelay; 
struct tlmeval Doubleclick; 

USHORT PointerMatrlxCPOINTERSIZE]; 

BYTE XOffset, YOffset; 
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USHORT color17, color18, color19; 

USHORT PolnterTlck; 

USHORT colorB, colorl, color2, colorj; 
BYTE VievXOffset, ViewYOffset; 

WORD VlewInltX, ViewInitY; 

BOOL EnableCLI; 

USHORT Printer-Type; 

UBYTE PrlnterFllename[FILENAME_SIZE]; 
USHORT PrlntPitch; 

USHORT PrintQuallty; 

USHORT PrintSpacing; 

UHORD PrintLeftMargin, PrintRightMargln; 
USHORT Printimage; 

USHORT PrintAspect; 

USHORT PrlntShade; 

WORD PrlntThreshold; 

USHORT PaperSize; 

UWORD PaperLength; 

USHORT PaperType; 

); 


struct RastPort { 
struct Layer «Layer; 
struct BitMap «BitMap; 
USHORT »AreaPtrn; 
struct TmpRas «TmpRas; 
struct Areainfo «Areainfo; 
struct Geisinfo «Geisinfo; 
UBYTE Mask; 

BYTE FgPen; 

BYTE BgPen; 

BYTE AOIPen; 

BYTE Drautlode; 

Byte AreaPtSz; 

Byte linpatcnt; 

BYTE dummy; 

USHORT Flags; 

USHORT LinePtrn; 

SHORT cp_x, cp_y; 

UBYTE minterms[8]; 

SHORT PenWidth; 

SHORT PenHeight; 
struct TextFont «Font; 
UBYTE AlgoStyle; 

UBYTE TxFlags; 

UWORD TxHeight; 

UWORD TxWidth; 

UWORD TxBaseline; 

WORD TxSpacing; 

APTR *RP_User; 

UWORD wordreserved[7]; 
ULONG longreserved[2]; 
UBYTE reserved[2]; 

1 ; 
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struct Resident { 

UWORD rt_MatchWord; 

struct Resident *rt_MatchTag; 

APTR rt_EndSkip; 

UWORD rt_Flags; 

UWORD rt_Version; 

UWORD rt_Type; 

BYTE rt_Pri; 
char *rt_Name; 
char *rt_IDString; 

APTR rt_Ynlt; 

); 

struct Screen { 

struct Screen »NextScreen; 
struct Window »FirstWindov; 

SHORT LeftEdge, TopEdge; 

SHORT Width, Helght; 

SHORT MouseY, MouseX; 

USHORT Flags; 

UBYTE »Title; 

UBYTE »DefaultTltle; 

BYTE BarHeight, BarVBorder, BarHBorder; 

BYTE MenuVBorder, HenuHBorder; 

BYTE WBorTop, WBorLeft, WBorRight, WBorBottom; 

struct TextAttr »Font; 

struct ViewPort ViewPort; 

struct RastPort RastPort; 

struct BltHap BltHap; 

struct Layer_Info Layerlnfo; 

struct Gadget »FlrstGadget; 

UBYTE DetailPen, BlockPen; 

USHORT SaveColorB; 
struct Layer »BarLayer; 

UBYTE »ExtData; 

UBYTE »UserData; 

}; 

struct Semaphore { 

struct MsgPort sm_MsgPort; 

WORD sm_Blds; 

}; 

struct SemaphoreRequest { 
struct MlnNode sr_Link; 
struct Task *sr_Waiter; 

}; 


struct SlgnalSemaphore { 
struct Node ss_Link; 

SHORT ss_NestCount; 

struct MinLlst ss_WaitQueue; 

struct SemaphoreRequest ss_MultlpleLlnk; 

struct Task *ss_0vner; 

SHORT ss_QueueCount; 
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struct SimpleSprlte { 
UHORD *posctldataj 
UHORD height; 

UHORD x, y; 

UHORD nun; 

}; 


struct Sprttelnage { 

UUORD posctldata[2]; 

UHORD sprdata[2][heightj; 
UHORD reserved[2]; 

); 

struct Task { 

struct Node tc_Node; 

UBYTE tc_Flags; 

UBYTE tc_State; 

BYTE tc_IDNestCnt; 

BYTE tc_TDNestCnt; 

ULONG tc_SigAlloc; 

ULONG tc_SlgHait; 

ULONG tc_SlgRecvd; 

ULONG tc_SlgExcept; 

UHORD tc_TrapAlloc; 

UUORD tc_TrapAble; 

APTR tc_ExceptData; 

APTR tc_ExceptCode; 

APTR tc_TrapData; 

APTR tc_TrapCode; 

APTR tc_SPReg; 

APTR tc_SPLower; 

APTR tc_SPUpper; 

VOID (*tc_Svltch)(); 

VOID (»tc_Launch)(); 

APTR tcJJserData; 

>; 

struct TextAttr { 

STRPTR ta_Name; 

UHORD ta_YSize; 

UBYTE ta_Style; 

UBYTE ta_Flags ; 

}; 


struct TextFont { 

struct Node TextNode; 
struct Message tf_Message; 
UHORD tf_YSize; 

UBYTE tf_Style; 

UBYTE tf_Flags; 

UUORD tf_XSlze; 

UHORD tf_Basellne; 

UHORD tf_BoldSnear; 

UHORD tf_Accessors; 

UBYTE tf_LoChar; 

UBYTE tf_HlChar; 

APTR tf_CharData; 

UHORD tf_Modulo; 





364 Die Stmctiires 


APTR tf_CharLoc; 
APTR tf_CharSpace; 
APTR tf_CharKern; 


struct ViewPort { 

struct ViewPort *Next; 
struct ColorHap »ColorMap; 
struct CopList »Dsplns; 
struct CopList »Sprlns; 
struct CopList »Clrlns; 
struct UCopList »UCopIns; 
SHORT DWldth, DHeight; 
SHORT DxOffset, DyOffset; 
UWORD Modes; 

UHORD reserved; 
struct Rasinfo »Raslnfo; 


struct VSprite { 

struct VSprite *NextVSprite; 
struct VSprite «PrevVSprlte; 
struct VSprite »DrawPath; 
struct VSprite »ClearPath; 
WORD OldY, OldXj 
WORD Flags; 

WORD Y, X; 

WORD Helght; 

WORD Width; 

WORD Depth; 

WORD Hedask; 

WORD HitHask; 

WORD *InageData; 

WORD «BorderLine; 

WORD »CollMask; 

WORD »SprColors; 
struct Bob »VBob; 

BYTE PlanePick; 

BYTE PlaneOnOff; 

VUserStuff VUserExt; 


struct WBObJect { 

struct Node wo_MasterNode; 
struct Node vo_Siblings; 
struct Node wo_SelectNode; 
struct Node vo_UtilityNode; 
struct WBOject *vo_Parent; 
/ifdef SMARTCOMPILER 
UBYTE wo_IconDisp:1; 

UBYTE wo_DrawerOpen:1; 

UBYTE wo_Selected:1; 

UBYTE vo_Background:1; 

/eise; 

UBYTE woFlags; 

/endif 

UBYTE wo_Type; 

USHORT wo_UseCount; 
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char *wo_Name; 

SHORT wo_NameX0ffset; 

SHORT wo_NameYOffset; 
char *wo_DefaultTool; 
struct DrawerData »wo_DrawerData; 
struct Window *wo_IconWin; 

LONG vo_CurrentX; 

LONG wo_CurrentY; 
char **wo_ToolTypes; 
struct Gadget vo_Gadget; 
struct FreeList wo_FreeList; 
char »wo_ToolWlndow; 

LONG vo_StackSlze; 

LONG woLock; 


struct Window { 

struct Window »NextWlndow; 

SHORT LeftEdge, TopEdge; 

SHORT Wldth, Height; 

SHORT MouseY, MouseX; 

SHORT MinWldth, MlnHeight; 

SHORT MaxWidth, MaxHeight; 

ULONG Flags; 

struct Menu »MenuStrip; 

UBYTE »Title; 

struct Requester »FirstRequester; 
struct Requester »DMRequest; 

SHORT ReqCount; 
struct Screen »WScreen; 
struct RastPort RPort; 

BYTE BorderLeft, BorderTop, BorderRight, BorderBottom; 

struct RastPort »BorderRPort; 

struct Gadget »FlrstGadget; 

struct Window »Parent, »Descendent; 

USHORT »Pointer; 

BYTE PtrHeight; 

BYTE PtrWidth; 

BYTE XOffset, YOffset; 

ULONG IDCMPFlags; 

struct MsgPort »UserPort, »WindowPort; 
struct IntulMessage »MessageKey; 

UBYTE DetailPen, BlockPen; 
struct Image »Checkmark; 

UBYTE »ScreenTltle; 

SHORT GZZMouseX; 

SHORT GZZMouseY; 

SHORT GZZWidth; 

SHORT GZZHeight; 

UBYTE »ExtData; 

BYTE «UserData; 
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Anhang C 
System Alerts 


In diesem Anhang wollen wir die System-Alerts aufführen, die mit dem Exec- 
Befehl »Alert(AlertNr,Para);« aufgerufen werden. 

Zuerst die allgemeinen Alerts. 

Für solch ein Alert muß man für AlertNr verschiedene Werte addieren: 

Das Alert soll den Amiga neu booten: AT_DeadEnd * 0x80000000 

Es Ist ein IO-Fehler: AG_I0Error = 0x00060000 

Der Fehler ist am Audioport aufgetreten: A0_AudioDev « 0x00008010 

Nun könnte man die verschiedenen Hexadezimalzahlen addieren, was die 
Zahl ergeben würde, die beim Alert mit ausgegeben wird, doch geht es viel 
einfacher: 


Alert(AT_DeadEnd+AG_IOError+AOAudloDev,0); 


Auf dem Bildschirm ist dann im Alert die Nummer zu sehen, die sich aus 
dieser Addidion ergibt. Der Programmierer kann auf diese Weise bei jedem 
auftretenden Alert zurückverfolgen, an welcher Stelle der Fehler aufgetreten 
ist. Im Normalfall wird von jedem Typ, also AT, AG und AO, ein Wert 
genommen, um ihn mit den anderen zu addieren. 

Anhand der folgenden Liste kann jeder auftretende Alerttyp analysiert wer¬ 
den: 


Alert-Typen 

Fehler-Art 


AT_DeadEnd 

AT_Recovery 

AG NoMemory 

AGJIakeLlb 

AG_OpenLib 

AG_OpenDev 

AG_OpenRes 

AG IOError 


0x80000000 

0x00000000 

0x00010000 

0X00020000 

0x00030000 

0x00040000 

0x00050000 

0x00060000 
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Fehler-Bereich 

AO ExecLib 

0x00008001 


AO GraphlcsLib 

0x00008002 


AO LayersLlb 

0x0000800? 


AO Intuition 

0x00008004 


AO MathLib 

0X00008005 


AO CListLib 

0x00008006 


AO DOSLib 

0x00008007 


AO RAMLib 

0x00008008 


AO IconLib 

0x00008009 


AO AudioDev 

0x00008010 


AO ConsoleDev 

0x00008011 


AO GamePortDev 

0x00008012 


AO KeyboardDev 

0x00008013 


AO TrackDiskDev 

0x00008014 


AO TimerDev 

0x00008015 


AO CIARsrc 

0x00008020 


AO DiskRsrc 

0x00008021 


AO MiscRsrc 

0x00008022 


AO BootStrap 

0x00008030 


AO_Uorkbench 

0x00008031 

Es stehen allerdings auch fertige Alerts 

zur Verfügung, die nur noch über- 

nommen werden müssen'ohne addiert zu werden: 

Beispielsweise Alert(AN ExecLib,0); 


Spezifische Alerts: 



exec.library 

AN ExecLib 

0x01000000 


AN ExcptVect 

0x81000001 


AN BaseChkSum 

0x81000002 


AN LibChkSum 

0x81000003 


AN LibMem 

0x81000004 


AN MemCorrupt 

0x81000005 


AN IntrMem 

0x81000006 


AN_lnitAPtr 

0x81000007 

graphics.library 

AN_GraphlcsLib 

0x02000000 


AN CopDisplay 

0x82000001 


AN Coplnstr 

0x82000002 


AN CopLlstOver 

0x82000003 


AN CopIListOver 

0x82000004 


AN CopListHead 

0x82000005 


AN LongFrame 

0x82000006 


AN ShortFrame 

0x82000007 


AN FloodFill 

0x82000008 


AN TextTmpRas 

0x02000009 


AN_BltBitMap 

0X8200000A 

layers.library 

AN_LayersLib 

0x03000000 
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Intuition.library 


math.llbrary 
eilst.llbrary 
dos.llbrary 


ramlib.library 
Icon, llbrary 
audio.devlce 
console.device 
gameport.devlce 
keyboard.devlce 
trackdlsk.devlce 

tlmer.devlce 

cla.resource 


AN_intuitlon 

AN_GadgetType 

AN_BadGadget 

AN_CreatePort 

AN_ItemAlloc 

AN_SubAlloc 

AN_PlaneAlloc 

AN_ItemBoxTop 

AN_OpenScreen 

AN_OpenScrnRast 

AN_SysScrnType 

AN_AddSWGadget 

AN_OpenWlndow 

AN_BadState 

AN_BadMessage 

AN_WelrdEcho 

AN_NoConsole 

AN_MathLlb 

AN_CListLlb 

AN_D0SLib 

AN_StartMem 

AN_EndTask 

AN_QPktFall 

AN_AsyncPkt 

AN_FreeVec 

AN_DlskBlkSeq 

AN_BltMap 

AN_KeyFree 

AN_BadChkSum 

AN_DlskError 

AN_KeyRange 

AN_BadOverlay 

AN_RAHLlb 

AN_lconLlb 

AN_AudioDev 

AN_ConsoleDev 

AN_GamePortDev 

AN_KeyboardDev 

AN_TrackDlskDev 

AN_TDCallbSeek 

AN_TDDelay 

AN_TlmerDev 

AN_TMBadReq 

AN CIARsrc 


0x04000000 

0x84000001 

0x04000001 

0x84000002 

0x0400000? 

0x04000004 

0x84000005 

0x84000006 

0x84000007 

0x84000008 

0x84000009 

0x8400000A 

0x8400000B 

0X8400000C 

0x8400000D 

0x8400000E 

0x8400000F 

0x05000000 

0x06000000 

0x07000000 

0x07000001 

0x07000002 

0x07000005 

0X07000004 

0X07000005 

0x07000006 

0x07000007 

0x07000008 

0x07000009 

0X0700000A 

0X0700000B 

0X0700000C 

0x08000000 

0x09000000 

0x10000000 

0x11000000 

0x12000000 

0x15000000 

0x14000000 

0x14000001 

0x14000002 

0x15000000 

0x15000001 

0x20000000 
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disk.resource 

AN DiskRsrc 

AN_DRHasDisk 

AN_DRIntNoAct 

0x21000000 

0x21000001 

0x21000002 

misk.resource 

AN_MiscRsrc 

0x22000000 

bootstrap 

AN_BootStrap 

AN_BootError 

0x30000000 

0x30000001 

vorkbench 

AN_Workbench 

0x31000000 



Anhang D 

Die DOS-Fehlermeldungen 


Mit dem Befehl IoErr kann der zuletzt aufgetretene Ein-/Ausgabe-Fehler 
abgefragt werden. IoErr gibt dabei eine Fehlernummer zurück. Diese Feh¬ 
lernummer kann anhand der folgenden Liste in Klartext umgewandelt wer¬ 
den: 


Fehlernummer 

Fehlertext englisch/deutsch 

103 

insufficient free störe 

Nicht genügend freier Speicherplatz 

104 

task table full 

Zuviele Tasks: Es können maximal 20 CLI-Tasks 
laufen 

120 

argument line invalid or too long 

Die Befehlszeile ist falsch oder ist zu lang 

121 

file is not an object module 

Die Datei ist nicht ladbar 

122 

invalid resident library during load 

Fehler in einer Befehls-Bibliothek 

202 

object in use 

Eine Datei kann nicht beschrieben und gleichzeitig 
gelesen werden 

203 

object already exists 

Datei besteht schon 

204 

directory not found 

Verzeichnis nicht gefunden 

205 

object not found 

Datei nicht gefunden 

206 

invalid window 

Ungültige Window-Dimension oder -Zuweisung 
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209 

packet request type unknown 

Ungültiger Device-Befehl 

210 

invalid stream component name 

Dateiname zu lang oder mit ungültigen Zeichen 

211 

invalid object lock 

Keine gültige Lock-Structure 

212 

object not of required type 

Ungültiger Typ (type dir ist nicht zulässig) 

213 

disk not validated 

Disk-Fehler oder Disk-Erkennung nicht abge¬ 
schlossen 

214 

disk write-protected 

Diskette ist schreibgeschützt 

215 

rename across devices attempted 
Dateinamenänderung nicht gültig 

216 

directory not empty 

Verzeichnis nicht leer 

218 

device not mounted 

Log. Gerät nicht auffindbar 

219 

seek error 

Seek-Befehl mit ungültigen Parametern 

220 

comment too big 

Kommentar zu lang 

221 

disk full 

Diskette ist voll 

222 

file is protected from deletion 

Datei ist vor löschen geschützt 

223 

file is protected from writing 

Datei ist vor überschreiben geschützt 

224 

file is protected from reading 

Datei ist vor lesen geschützt 

225 

not a DOS disk 

Diskette nicht mit DOS-Format 

226 

no disk in drive 

Keine Diskette im Laufwerk 
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232 no more entries in directory 

Im Verzeichnis sind keine weiteren Dateien mehr 
vorhanden 
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Anhang E 


Anmerkungen zur 
Programmgestaltung 


Commodore hat einige Rahmenrichtlinien erstellt, an die sich jeder Amiga- 
Programmierer halten sollte. Diese wollen wir an dieser Stelle aufführen: 

MENU Menüpunkte, die im Programm momentan keine 

Bedeutung haben, sollten mit dem Befehl 
»OffMenuQ« abgeschaltet werden, da der Benut¬ 
zer einen solchen Menüpunkt nicht anwählen soll, 
wenn anschließend nichts geschieht. 

MENU Benötigt Ihr Programm mehrere Windows, mit 

unterschiedlichen Menüs, sollten diese farblich 
unterschieden werden. 

MENU Arbeitet Ihr Programm mit Dateien, sollte das 

»LOAD/SA VE«-Menü folgende Menüpunkte 
besitzen: 

NEW Neue Datei erstellen 

OPEN Alte Datei laden 

SAVE Datei unter dem Namen speichern, 

unter dem sie geladen wurde. 

SAVE AS.. Datei unter neuem Namen spei¬ 
chern 

PRINT Datei drucken 

PRINT AS Teil einer Datei drucken oder neue 

Druckerparameter wählen 
QUIT Beenden des Programms 

GADGET Wenn über Gadgets abgefragt wird, ob das Pro¬ 

gramm eine Handlung durchführen soll, sollte das 
Gadget, das dieses beneint, immer hervorgehoben 
werden. 

Gadgets sollten sich niemals überlappen. 


GADGET 
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GADGET 


REQUESTER 


REQUESTER 


MAUS 


Genauso wie Menüs, sollten auch Gadgets mit 
OffGadget abgeschaltet werden, wenn sie keine 
Funktion mehr haben. 

Es sollte immer eine Möglichkeit gegeben werden, 
diesen Requester zu verlassen. Zum Beispiel sollte 
bei einem Requester, der abfragt, ob die eingelegte 
Diskette wirklich formatiert werden soll, auf jeden 
Fall ein Gadget vorhanden sein, das dies verneint. 
Dieses Gadget sollte hervorgehoben sein. 

Bei Requestern, die nur zwei Auswahlmöglichkei¬ 
ten bieten, sollte immer die sichere Option auf der 
rechten Seite erscheinen, während auf der linken 
Seite die Durchführung der entsprechenden Funk¬ 
tion vom Benutzer bejaht wird. 

Für Abfragen sollte immer die linke Maustaste 
verwendet werden, während die rechte für 
Menüabfragen zur Verfügung steht. 




Anhang F 

Drucker-Codes 


Mittels der Printer-Device kann der Drucker eingestellt werden. Dazu muß 
allerdings in der Structure angegeben werden, welche Einstellung geändert 
werden soll und eventuell müssen auch noch die neuen Parameter angegeben 
werden. 

Steht bei den Escape-Funktionen ein »n«, so müssen Parameter mit angege¬ 
ben werden: 


CODE 

NR. 

ESCAPE 

BEMERKUNG 

aRIs 

0 

ESCc 

Rücksetzung des Druckers 

aRIN 

1 

ESC/1 

Initialisierung 

alND 

2 

ESCD 

Zeilenvorschub 

aNEL 

5 

ESCE 

Return und Zeilenvorschub 

aRI 

4 

ESCH 

Umgekehrter Zeilenvorschub 

aSGR0 

5 

ESC[0m 

Normaler Zeichensatz 

aSGR5 

6 

ESC[5m 

Kursivschrift ein 

aSGR25 

7 

ESC[25m 

Kursivschrift aus 

aSGR4 

8 

ESCt 4m 

Unterstreichen ein 

aSGR24 

9 

ESC[24m 

Unterstreichen aus 

aSGRI 

10 

ESCCIm 

Fettdruck ein 

aSGR22 

11 

ESCC 22m 

Fettdruck aus 

aSFC 

12 

ESCCnm 

Vordergrundfarbe setzen 

aSBC 

15 

ESCCnm 

Hintergrundfarbe setzen 

aSHORPB 

14 

ESCC0V 

Normaler Zeichenabstand 

aSH0RP2 

15 

ESC[2v 

Elite ein 

aSHORPI 

16 

ESCClv 

Elite aus 

aSH0PR4 

17 

ESCC4v 

Kleinschrift ein 

aSHORPJ 

18 

ESCC5v 

Kleinschrift aus 

aSH0RP6 

19 

ESCC6v 

Breitschrift ein 

aSH0RP5 

20 

ESCC5v 

Breitschrift aus 

aDEN6 

21 

ESC[6"z 

Schattendruck ein 

aDEN5 

22 

ESCC5”z 

Schattendruck aus 

aDEN4 

25 

ESC[4”z 

Doppeldruck ein 

aDEN5 

24 

ESC[5”z 

Doppeldruck aus 

aDEN2 

25 

ESCC2”z 

Schönschrift ein 

aDENI 

26 

ESCC1"z 

Schönschrift aus 

aSUS2 

27 

ESC[2v 

Hochstellung ein 

aSUSI 

28 

ESCClv 

Hochstellung aus 

aSUS4 

29 

ESCC4v 

Tiefstellung ein 

aSUS5 

50 

ESCC5v 

Tiefstellung aus 

aSUS0 

51 

ESCC0V 

Zeilen-Normalisierung 

aPLU 

52 

ESCL 

Zeile auf 

aPLD 

55 

ESCK 

Zeile ab 
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aFNTB 

34 

ESC(B 

US - Zeichensatz 

aFNTI 

35 

ESC (R 

Französicher Zeichensatz 

aFNT2 

56 

ESC (K 

Deutscher Zeichensatz 

aFNTJ 

37 

ESC(A 

Englischer Zeichensatz 

aFNT4 

38 

ESC (E 

Dänischl Zeichensatz 

aFNT5 

39 

ESC(H 

Schwedischer Zeichensatz 

aFNT6 

40 

ESC(Y 

Italienischer Zeichensatz 

aFNT7 

41 

ESC (Z 

Spanischer Zeichensatzt 

aFNT8 

42 

ESC( J 

Japanischer Zeichensatzt 

aFNT9 

43 

ESC (6 

Norwegischer Zeichensatzt 

aFNT10 

44 

ESC(C 

Dänisch2 Zeichensatzt 

aPR0P2 

45 

ESC[2p 

Proportionalschrift ein 

aPROPI 

46 

ESC[1p 

Proportionalschrift aus 

aPROP0 

47 

ESC[0p 

Proportionalschrift löschen 

aTSS 

48 

ESC[n E 

Proportionalschrift-Offset setzen 

aJFY5 

49 

ESCC5 F 

Linksbündiger Druck 

aJFY7 

50 

ESC[7 F 

Rechtsbündiger Druck 

aJFY6 

51 

ESC[6 F 

Blocksatz ein 

aJFY0 

52 

ESC[0 F 

Zeilen-Justierung aus 

aJFY3 

53 

ESCC3 F 

Zeichenbreite setzen 

aJFYI 

54 

ESC[1 F 

Zeilenzentrierung 

aVERP0 

55 

ESC[0z 1/8 

Zeilenschaltung 

aVERPI 

56 

ESC[1z 1/6 

Zeilenschaltung 

aSLPP 

57 

ESCtnt 

Papierlänge setzen 

aPERF 

58 

ESC[nq 

Blattendeübersprung ein 

aPERF0 

59 

ESC[0q 

Blattendeübersprung aus 

aLHS 

60 

ESC/9 

Linken Rand setzen 

aRMS 

61 

ESC/0 

Rechten Rand setzen 

aTMS 

62 

ESC/8 

Oberen Rand setzen 

aBMS 

63 

ESC/2 

Unteren Rand setzen 

aSTBM 

64 

ESC[n;nr 

Oberen und unteren Rand setzen 

aSLRM 

65 

ESC[n;ns 

Linken und rechten Rand setzen 

aCAM 

66 

ESC/3 

Ränder löschen 

aHTS 

67 

ESCH 

Horizontale Tabs setzen 

aVTS 

68 

ESCJ 

Vertikale Tabs setzen 

aTBC0 

69 

ESC[0g 

Horizontalen Tab löschen 

aTBC3 

70 

ESC[3g 

Alle horizontalen Tabs löschen 

aTBCI 

71 

ESCClg 

Vertikalen Tab löschen 

aTBC4 

72 

ESC[4g 

Alle Vertikalen Tabs löschen 

aTBCALL 

73 

ESC/4 

Alle horiz. und vert. Tabs löschen 

aTBSALL 

74 

ESC/5 

Normale Tabs setzen 

aEXTEND 

75 

ESC[n"x 

Erweiterungsbefehle 




Anhang G 

Die Demo-Diskette 


Auf der heiligenden Diskette befinden sich eine Vielzahl von Demonstratio¬ 
nen zu den verschiedenen Themen in diesem Buch. Diese Programme sind in 
fünf Verzeichnisse eingeteilt. Diese stimmen mit denen aus diesem Buch 
(siehe Inhaltsverzeichnis) überein. Wenn Sie auf diese Programme zugreifen 
wollen, so müssen Sie als Erstes in das CLI. Wie dies geschieht, ist ausführ¬ 
lich in Kapitel 1 beschrieben. Anschließend können Sie sich das Inhaltsver¬ 
zeichnis mittels »dir "m&t demodisk" opt a« ausgeben lassen. Sie sehen nun 
alle Einträge auf der Diskette. 

Zusätzlich zu den fünf Inhaltsverzeichnissen befinden sich noch weitere 
Dateien auf der Diskette. Diese haben folgende Bedeutung: 

Converter Dies ist das Konvertierungsprogramm aus Kapitel 

10. Es läßt sich nur starten, wenn gleichzeitig Basic 
aufgerufen werden kann. Zum Benutzen sollten Sie 
es also auf Ihre Basic-Diskette kopieren (»copy 
"m&t demodisk:Converter" to xxxxx«), 

IFFBild Diese Datei enthält das Bild, das mit der IFF- 

Read-Demonstration eingeladen wird. Dazu muß 
sich die Diskette allerdings in dem Laufwerk »dfO:« 
befinden. 

testbild Kompiliertes C-Programm, zum Einstellen des 

Monitors. 

testbild.c Source-Code von »testbild«. 

Titelbild Bild-File, das durch die Dosdemo eingelesen wird. 

Dazu muß sich allerdings die Diskette in Laufwerk 
»dfO:« befinden. 

Zudem befinden sich noch einige .info-Dateien auf der Diskette, die die 
Icons für die »Scubladen« enthalten. 
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Die eigentlichen C-Programme befinden sich in den Verzeichnissen, wenn 
man von »testbild« einmal absieht. Auf diese Programme kann recht einfach 
zugegriffen werden. Am vorteilhaftesten ist es, wenn Sie als Erstes die 
Demonstrationsdiskette als aktuelles Verzeichniss setzen. Dies geschieht mit 
»cd "m&t demodisk"«. Wenn Sie nun die Demonstration »hamdemo« akti¬ 
vieren wollen, so müssen Sie wissen, in welchem Verzeichniss es sich befin¬ 
det. Mit »dir opt a« geht dies leicht. Aufrufen können Sie die Demonstration 
nun durch »grafikgrund/hamdemo«. In der Datei »hamdemo.c« befindet sich 
der Source-Code zum Programm. Ihn können Sie mit »ed 
grafikgrund/handemo.c« editieren. Wollen Sie anschließend den Editor ver¬ 
lassen, ohne das Programm wieder zu speichern, so drücken Sie die »ESC«- 
Taste, »q« und anschließend »RETURN«. 

Wollen Sie ein Programm nicht nur vom CLI, sondern auch von der 
Workbench aus starten, so müssen Sie auf dieser das Icon »M&T 
DemoDisk" anklicken. Anschließend erscheinen fünf »Schubladen«, in denen 
sich die Programme befinden. Allerdings besitzen nicht alle Programme ein 
Icon, da diese dann nicht von der Workbench aus zu starten sind. 

Folgende Programme befinden sich auf Ihrer Demonstrationsdiskette (In 
Klammern stehen die Dateien mit dem gleichen Namen, aber mit Kürzel .c 
oder .info angehängt. Ist das Kürzel .info vorhanden, so kann das Programm 
auch von der Workbench aus gestartet werden.): 

Verzeichnis SONDERTEIL: 


iffreaddemo 
(.c und .info) 

Liest das Bild IFFBILD im IFF-Format ein. 

iffwritedemo 

(.cund.info) 

Öffnet einen Screen und schreibt diesen unter 
dem Namen Demoscreen auf Diskette. 

mathdemo 
(c. und .info) 

Führt eine Anzahl Berechnungen mittels der Math- 
Libraries durch. 

multidemo 

(.cund.info) 

Öffnet zwei Windows, in die unabhängig vonein¬ 
ander gezeichnet wird. 

narratordemo 
(.c und .info) 

Spricht einen Satz zu Ihnen. 
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Verzeichnis GRAFIKTEIL: 


areademo 
(.c und .info) 

Zeichnet zwei Polygone auf einen Screen. 

graphicdemo 

(.cund.info) 

Zeigt die Möglichkeiten verschiedener 
Grafikbefehle. 

imagedemo 
(.c und .info) 

Demonstration für Images und Borders. 

pointerdemo 

(.cund.info) 

Zeigt eine Animationsmöglichkeit mit dem 
Mauszeiger. 

prefdemo 
(.c und .info) 

Verschiebt sämtliche Screens hardwaremäßig. 

spritedemo 
(.c und .info) 

Animation mit Hardware-Sprites. 

textdemo 

(.cund.info) 

Zeigt die Möglichkeiten der Verwendung von 
verschiedenen Zeichensätzen. 

vspritedemo 
(.c und .info) 

Zeigt die Animation mit VSprites. 


Verzeichnis GRAFIKGRUND: 

halfbritedemo 
(.c und .info) 

hamdemo 
(.c und .info) 

screendemo 
(,c und .info) 

windowdemo 
(.c und .info) 


64 Farben auf dem Amiga. 


Die Steigerung: 4096 Farben gleichzeitig. 


Zeigt die Verwendung von Screens. 


Verschiedene Windowtypen auf der Workbench. 


Verzeichnis EINAUSGABE: 

dosdemo 
(nur .c) 


dosprinterdemo 
(nur .c) 

druckerdemo 
(.c und .info) 


Lädt ein Bild von Diskette. Die Demonstrations¬ 
diskette muß sich dabei im Laufwerk »dfO:« 
befinden. 

Gibt einen kurzen Text auf dem Drucker aus. 


Erweiterte Druckerkontrolle über die Device. 
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dumpdemo 
(.c und .info) 

einfache Hardcopy-Routine. 

Verzeichnis BEDIENUNG: 


alertsdem 
(x und .info) 

Zeigt die Verwendung von Intuition-Alerts. 

autoreqdemo 
(.c und .info) 

Einfacher Requester. 

dmreqdemo 

(.cund.info) 

Double-Menü-Requester. Dazu muß nach dem 
Starten des Programms zuerst zweimal die rechte 
Maustaste betätigt werden, damit der Requester 
erscheint. 

execalertdemo 
(.c und .info) 

Zeigt zwei Exec-Alerts. 

gadgetdemo 

(.cund.info) 

Die verschiedenen Möglichkeiten für User-Gadgets 

menudemo 
(.c und .info) 

Zeigt die Variationsmöglichkeiten bei Menüs. 




Stichwortverzeichnis 


A 

ActivateWindow 75 
AddFont 117 
AddFreeList 288 
AddGadget 218 
AddVSprite 154 
Alerts 182, 231f 
AllocWBObject 289 
AMIGA-DOS 277 
Animation 139,168,174 
AnimObjects 139 
Arbeitsoberfläche 287 
Area 94 
AreaCircle 94 
AreaDraw 95 
AreaEllipse 95 
AreaEnd 96 
AreaMove 97 
AskFont 118 
AskSoftStylc 119 
Ausdruck 279 
AUTOKNOB 215 
AutoRequest 244 
AvailFonts 119 

ß 

Backdrop-Window 68 
Bedingungen 24 
BEEP1NG 50 
Begin Refresh 76 
Benutzeroberfläche 181 
Betriebssystem 181, 305 
Bibliotheken 29 
Bildfrequenz 39 
Bildschirm 39,174 
BitMap 51, 67 
BitMapHeadcr 332 
BitPlanes 40, 130 
Blitter-Objekts 139 
BMHD 332 
BNDRYOFF 97 


Bob 139 
BODY 332 

Boolean-Gadget 201, 210 
Borderless-Window 66 
Borders 93,132 
BuildSysRequest 245 
BumpRevision 290 

c 

CAMG 332 
CCRT 332 
ChangePri 307 
ChangeSprite 143 
Checkmark 182 
CHIP-Memory 39 
ClearDMRequest 246 
ClearEOL 121 
ClearMenuStrip 188 
ClearPointer 76,170 
ClearScreen 121 
CLI 181,277,306 
clist.library 345 
Close 257 
Ciose-Gadget 71 
CloseFont 121 
CloseScreen 52 
CloseWindow 77 
CloseWorkbench 52 
CMAP 332 
CMHD 332 
ColorMap 332 
ColorRange 332 
Command-Tasten 193 
Copper-Liste 40 
CPU 39 
CreateDir 257 
CreateTask 308 
CRNG 332 
CurrentDir 258 
CurrentTime 342 
Custom-Chips 39 
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Custom-Scrcens 41,45 
CUSTOMBITMAP 50 
CUSTOMSCREEN 50 
Cyclelnfo 332 

D 

Datentyp 22 
DeadEnd-Alerts 232 
DeleteFile 258 
DeleteTask 309 
Devices 34 
Diskette 271,287 
diskfont.library 346 
DisplayBeep 53 
doppelte Genauigkeit 313f 
DOS 255,371 
dos.library 346 
Doubleclick 343 
DPPV 332 
Draw 98,117 
DrawCircle 98 
DrawEllipse 99 
DrawGList 155 
Drawlmage 129 
Drucker 277 
DUALPF 42 
DupLock 259 

E 

EndRefresh 78 

EndRequest 246 

Examine 259 

Exec 232, 367 

exec.library 347 

Execute 260 

execsupport.library 348 

ExNext 261 

Extra-Halfbright 40 

EXTRA HALFBRIGHT 44, 46 

F 

Farben 40 
Farbregler 40 
Farbtabelle 40 
FAST-Memory 39 
Fenster 39 
FFP-Zahlen 313 
Flags 50 
Flood 99 
FORM 332 
FreeDiskObject 291 
FreeFreeList 292 


FreeSprite 144 
FreeSysRequest 246 
FreeWBObject 293 

G 

Gadget 65, 71, 93,129,132, 182, 201, 375 

Gadget-Typ 182 

GENLOCK VIDEO 44 

GetDefPrefs 175 

GetDiskObject 294 

Getlcon 295 

GetPrefs 176 

GetRGB4 100 

GetSprite 145 

GetWBObject 296 

gfxmacros 354 

Gimmezerozero-Window 66 

Gleitkomma-Zahlen 313 

Grafiken 193 

graphics.library 348 

H 

HAM 40, 42f, 46 
Hardcopy 279 
Hardware-Sprites 139 
HIRES 42, 43, 46 
Hold-And-Modify 40, 42 
Hot-Spot 168 

I 

Icon 287 

IDCMP 71,194, 216 
IFF 331 
ILBM 332 
Images 93, 129 
Info 261 
InitArea 100 
InitGels 156 
InitMasks 157 
InitRequest 247 
InitTmpRas 101 
Input 262 

Interchange-File-Format 331 
Interlace 39, 42 
IntuiText 137 
Intuition 39, 71 
Intuition-Alert 235 
Intuition-Text 137 
intuition.library 351 
IOError 262, 371 
Islnteractive 262 
ItemAddress 189 
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ITEMNUM 189 
Items 186 
ITEMTEXT 193 

K 

Kickstart 175 
Kollisionsabfrage 153 

L 

LACE 43, 46 
Lattice-C 15 
layers.library 352 
LoadView 157 
Lock 263 

M 

Macros 354 
MakeScreen 53 
mathffp-Library 314 
mathffp.library 353 
mathieeedoubbas.library 314, 354 
mathtrans.library 353 
Maus 140,168,182 
MAUS 376 
Mauszeiger 141, 185 
MENU 375 
Menuitem 186 
Menükasten 186 
MENUNUM 190 
Menüoberbegriff 182, 186 
Menüpunkt 185 
Menüs 182, 185 
Menüschalter 182 
Menüunterpunkte 182 
Menüzeile 186 
ModifylDCMP 79 
ModifyProp 218 
Move 102, 117 
MoveScreen 54 
MoveSprite 145 
MoveWindow 80 
MrgCop 157 
Multitasking 65, 305 
MutualExclude 193 

N 

Narrator-Device 301 
NewScreen 41, 45 
NewWindow 72 
NOCAREREFRESH 69 
Normal-Window 66 


o 

OffGadget 220 
OffMenu 190 
OFFDISPLAY 102,354 
OFFSPRITE 146,354 
OnGadget 221 
OnMenu 191 
ONDISPLAY 103,354 
ONSPRITE 146,354 
Open 264 
OpenDiskFont 122 
OpenFont 123 
OpenScreen 47,54 
OpenWindow 80 
OpenWorkBench 55 
Output 264 

P 

ParentDir 265 
PlaneOnOff 130 
PlanePick 130 
Playfields 42, 140 
PolyDraw 103 
Polygone 93 

Preferences 140,174, 277 
PrintlText 137 
Programmbedienung 181 
Proportional-Gadget 201, 214 
Pull-Down-Menü 65, 71 
PutDiskObject 297 
Puticon 298 
PutWBObject 299 

R 

RastPort 40, 49,51, 133 
Read 265 
ReadPixel 104 
Rechtecke 93 
Recovery-Alerts 232 
RectFill 104 
RefreshGadgets 221 
RefreshWindowFrame 81 
RemakeDisplay 55 
RemFont 123 
RemoveGadget 222 
RemTask 310 
RemVSprite 158 
Rename 266 
ReportMouse 82 
Request 247 
Requester 183, 237, 376 
RethinkDisplay 56 
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s 

SPPow 326 

Scheduling 305 

Sprachausgabe 301 

Schleifen 26 

Sprites 42,44,139,141 

Schriften 117 

SPSin 322 

Screen 39,47,49,93 

SPSincos 323 

ScreenToBack 56 

SPSinh 324 

ScreenToFront 56 

SPSqrt 327 

ScrollRaster 105 

SPSub 318 

ScrollVPort 105 

SPTan 323 

Seek 267 

SPTanh 324 

SetAfPt 106 

SPTieee 327 

SetAPen 107 

SPTst 316 

SetBPen 107 

Steuerzeichen 279 

SetComment 268 

Structures 355 

SetDMRequest 248 

Strukturen 27 

SetDrMd 108 

Subitem 186, 193 

SetDrPt 109 

SUBNUM 192 

SetFont 123 

SUPERBITMAP 69 

SetMenuStrip 191 

SuperBitMap-Window 67 

SetOPen 109 

System Alerts 367 

SetPointer 82,140,168 

System-Gadgets 65, 70, 201f 

SetPrefs 176 

System-Meldungen 231 

SetProtection 268 

Set Rast 109 

System-Requester 231 

SetRGB4 48,57,110 

T 

SetSoftStyle 124 

Tasks 305 

SetWindowTitles 84 

Text 117,125,137 

SetWrMsk 110 

TEXT-Gadgets 202 

SHOWTITLE 50 

Text/Integer-Gadget 211 

ShowTitle 58 

Textcursor 117 

SIMPLEREFRESH 69 

Texte 93 

SizeWindow 85 

TextLength 125 

SMARTREFRESH 69 

Translator-Libraiy 301 

SortGList 158 

SPAbs 317 

Transzendale Funktionen 320 

SPAcos 321 

u 

SPAdd 317 

Umrahmungen 132 

SPAsin 321 

SPAtan 321 

Unlock 269 

SPCmp 316 

V 

SPCos 322 

VBeamPos 111 

SPCosh 324 

View-Modi 43 

SPDiv 319 

ViewPort 40, 49, 51 

Speicher 39 

ViewPortAddress 85 

SPExp 325 

virtuelle Sprites 139,152 

SPFieee 327 

VP HIDE 44 

SPFix 315 

SPFlt 315 

VSprites 139, 152 

SPLog 325 

w 

SPLoglO 326 

WaitBOVP 111 

SPMul 318 

WaitForChar 269 

SPNeg 317 

WaitTOF 112, 159 
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WBENCHSCREEN 50 

WindowLimits 86 

WBenchToBack 58 

WINDOWSIZE 70 

WBenchToFront 59 

WindowToBack 87 

Window 39, 65, 93 

WindowToFront 87 

Window-Befehle 72 

Workbench 141, 175, 287, 306 

Window-Gadgets 70 

Write 270 

Window-Refreshing 69 

WritePixcl 112 

Window-Typ 66 

WINDOWCLOSE 70 

z 

WINDOWDEPTH 70 

Zeiger 23 

WINDOWDRAG 70 

Zeilensprungverfahren 39,43 
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Commodore-Amiga Inc 
Das Amiga-DOS- 
Handbuch für Amiga 
500, 1000 und 2000 

1988, 342 Seiten 
Die Pflichtlektüre für jeden 
Commodore-Amiga- 
Anwender und Program¬ 
mierer: eine Entwickler- 
Dokumentation zum 
Amiga-DOS-Betriebs- 
system. Version 1.2. 
Programmierung, interne 
Datenstruktur und Disket¬ 
tenhandling. Mit diesem 
Buch lernen Sie das 
mächtige Amiga DOS 
schnell und sicher zu 
beherrschen. Alle Mög¬ 
lichkeiten des Systems, 
bis hin zum »Multi-Tasking« 
werden ausführlich und 
anschaulich beschrieben. 
Best.-Nr. 90465 
ISBN 3-89090-465-3 
DM 59- 
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Kremser/Koch 

Amiga 

Programmierhandbuch 

1987, 387 Seiten, 
inkl. Diskette 

Eine tolle Einführung in die 
»Interna« des Amiga: Die 
wichtigsten Systembiblio- 
theken. die das Betriebs¬ 
system zur Verfügung stellt, 
werden anhand vieler Bei¬ 


spiele erklärt. Aus dem 
Inhalt: Aufruf der Betriebs¬ 
system-Routinen unter C, 
Aufruf der DOS-Funktionen, 
Programmieren von Win¬ 
dows, Screens und Gad- 
gets. Grafik und Animation, 
Tips und Tools in C. 
Best.-Nr. 90491 
ISBN 3-89090-491-2 
DM 69,- 



M Breuer 

Das Amiga-500- 

Handbuch 

1987 489 Seiten 
Eine ausführliche Einfüh¬ 
rung in die Bedienung 
des Amiga 500. Kennen¬ 
lernen und Anwenden der 
neuen Computer-Techno¬ 
logie: Systemarchitektur, 
Workbench 1.2, Intuition, 
CLI, Amiga-Grafik. Sound- 
Erzeugung, Amiga-BASIC 
und Schnittstellen. Neben 
dem Handbuchteil mit 
vielen Bildschirmfotos und 
Übersichtstabellen, die 
Ihnen beim täglichen Ein¬ 
satz helfen, schnell und 
reibungslos zu arbeiten, 
enthält das Buch eine 
ausführliche Beschrei¬ 
bung des Amiga 500 und 
seines Zubehörs. 

Best.-Nr. 90522 
ISBN 3-89090-522-6 
DM 49,- 
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Haben Sie das Eintippen satt? 
Zing! ermöglicht Ihnen den 
mausgestutzten Zugriff auf Ihr 
Amiga-Betriebssystem. 

Dieses Programm ubernimml 
die lästige und fehleranfällige 
Tipparbeit beim Arbeiten mit 
dem Betriebssystem Ihres 
Amiga. Zmg! befindet sich nach 
dem erstmaligen Abrufen im 
Hintergrund und kann mit Hilfe 
von sogenannten »Hotkeys« 
jederzeit in Aktion treten. Volle 
Multitasking-Fähigkeit ist selbst¬ 
verständlich. Wahlweise über 
Maus oder Funktionstasten 
stehen Ihnen speicherresident 
unter anderem folgende Funk¬ 
tionen zur Verfügung. 

• Verzeichnis wechseln - Anzei¬ 
gen eines Dateibaums - Dateien 
kopieren - Dateien umbenennen 
- Dateien schreibschülzen - 
Restspeicheranzeige - Dateien 
löschen - Dateien zusammen¬ 
führen - Daleien verlagern - 
Verzeichnisse erstellen - Datei¬ 
kommentar erstellen - System¬ 
statusanzeige - automatische 
Bildschirmabschaltung (Screen 
Saver). . . und vieles mehr! Die 
Auswahl der Dateien kann mit 
der Maus vorgenommen 
werden, mögliche Kriterien sind 
zum Beispiel auf Dateinamen 


SOFTWARE 
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• Unverbindliche Preisempfehlung 


basierende Sortiermuster oder 
der Zeitpunkt der Dateierstel¬ 
lung. Verzeichnisanzeige mit 
Schnellsortierdurchlauf ist bei 
Zmg! genauso selbstverständ¬ 
lich wie die Möglichkeit, sowohl 
ganze Dateibäume als auch 
Teile von ihnen zu kopieren. Zu¬ 
sätzlich enthält das Programm 
viele nützliche Dienstprogram¬ 
me, zum Beispiel: 

• Druckerspooler - Bild¬ 
schirmausdruck - Speichern 
eines Bildschirms als IFF-Grafik 
- Überwachung von anderen 
Programmen 

• Umbelegung der Funktions¬ 
tasten - interne Symbol¬ 
zuweisung 

• Diskcopy-Funktion - Disket¬ 
ten installieren - Disketten 
umbenennen - Disketten 
formatieren - direkter Aufruf 
von Programmen 

Lieferumfang: 

• deutsche Programmversion 
auf 3'f/-Diskette 

• Handbuch deutsch 

Hardware-Anforderungen: 

• Amiga 500,1000 oder 2000 

Software-Anforderung 

(speziell für Amiga 1000) 

• Kickstart 33.180 (Version 1.2) 
oder höher 
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Definieren Sie individuelle, leistungsstarke Tastatur- 




und Maus-Makros für alle Anwendungsbereiche. 


Jeder Amiga-Besitzer kennt 
das: mühselig mechanisch 
ausgeführte Eingaben von Ta¬ 
stenfolgen zum Aufrufen einer 
bestimmten, immer wiederkeh¬ 
renden Funktion. Spazierfahr¬ 
ten mit der Maus kreuz und 
quer über den ganzen Bild¬ 
schirm, Zeitverluste bei der 
Fensterverwaltung. 

Mit Zing! Keys können Sie all 
dies und noch viel mehr einfa¬ 
cher und effektiver gestalten. 
Ein Tastendruck, und die erfor 
derlichen weiteren Eingaben 
werden automatisch abgear¬ 
beitet. Dies gilt auch für 
Intuition-Funktionen (Fenster 
öffnen oder schließen, Bewe¬ 
gen des Mauszeigers usw.) 
und für Betriebssystembefehle. 
Stellen Sie sich Ihre eigenen 
für jede Anwendung verschie¬ 
denen Makros zusammen und 
laden Sie eine spezielle Tasta¬ 
turbelegung, wenn Sie sie be¬ 
nötigen. 

Funktionen von Zing! Keys: 

• Sicherheitstastatursperre 

• Hochleistungstasteneditor 

• Speichern von CLI- 
Kommandofolgen 

• Belegungen laden/spei- 
chern/zusammenfuhren 

• Makros speichern, auch 
Verschachtelungen 

• Bildschirmmhalt als IFF- 
Grafik speichern 

• Verzögerungsfunktion 
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Definieren Sie individuelle, leistungsstarke Tastatur- und Maus-Makros 
für alle Anwendungsbereiche Fenstermanagemen!. Programmstort oder Abarbeitung 
CU Befehlsfolgen über einen Tastendruck 
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• Bildschirmabschaltung 

• Datums-und Zellfunktion 

• Überspringen von 
Makrofunktionen 

• Fenster vergrößernder 
kleinern 

• Fenster bewegen 

• Fenstergrößen speichern 

• Fenster öffnen/schließen 

• Fenster in den Vorder¬ 
oder Hintergrund bringen 

• Makros vorübergehend 
stillegen 

• Makros wieder aufneh¬ 
men 

• Einbindung von Variablen 
in Makros 

• Laufende Makros unter¬ 
brechen 

• Bildxhirmmhalt aus 
drucken 

• Belegungen löschen 

• Bildschirm ein- und aus¬ 
schalten 

• automatische Fenster¬ 
aktivierung 

• Speichern von Maus¬ 
bewegungen 

Diese und weitere Funktio¬ 
nen helfen Ihnen dabei, die 
für Sie passenden Belegun¬ 
gen und Abläufe zu pro- 
gtammieren und zu spei¬ 
chern Ein unentbehrliches 
Werkzeug für jeden Amiga- 
Besitzer 1 
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Bitte schneiden Sie diesen Coupon aus, und schicken Sie ihn in einem Kuvert an: 
Markt&Technik Verlag AG, Bucnverlag, Hans-Pinsel-Straße 2, 8013 Haar 
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Computerliteratur 
und Software vom 
Spezialisten 

l 

Vom Einsteigerbuch für deh Heim- oder Personalcom¬ 
puter-Neuling über professionelle Programmierhand¬ 
bücher bis hin zum Elektronikbuch bieten wir Ihnen inter¬ 
essante und topaktuelle Tit|sl für 


• Apple-Computer • Atafi-Computer • Commodore 
64/128/16/116/Plus 4 • Schpeider-Computer • IBM-PC, 
XT und Kompatible 

sowie zu den Fachbereichen Programmiersprachen • 
Betriebssysteme (CP/M, Mfj-DOS, Unix, Z80) • Textver¬ 
arbeitung • Datenbanksystpme • Tabellenkalkulation • 
Integrierte Software • Mikroprozessoren • Schulungen. 
Außerdem finden Sie professionelle Spitzen-Programme 
in unserem preiswerten Software-Angebot für Amiqa, 


Atari ST, Commodore 128, 
Computer und für IBM-PCs 


128 D, 64, 16, für Schneider¬ 
und Kompatible! 


Fordern Sie mit dem nebenstehenden Coupon unser 
neuestes Gesamtverzeichnis und unsere Programmser¬ 
vice-Übersichten an, mit hilfreichen Utilities, professionel¬ 
len Anwendungen oder packenden Computerspielen! 
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(PS: Wir speichern Ihre Daten und verpflichten uns zur 
Einhaltung des Bundesdatenschutzgesetzes) 
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Jetzt stehen Ihnen die 
Funktionen Ihres Amiga- 
Command-Line-Interface per 
Mausklick zur Verfügung! 

Mit diesem Programm können 
Sie die Befehle des Command- 
Line-Interface (CU) benutzer¬ 
freundlich und schnell per 
Mausklick verwenden! 

Ihre Super-Vorteile mit 
CLImatel.2: 

• sehr große Übersichtlichkeit 
der Bildschirmdarstellung 
(Sie haben alle Funktionen 
auf einen Blick) 

• leichte Bedienung aller 
Befehle mit der Maus 

• drei externe Laufwerke 

(3 V' oder 5V4"), zwei Fest¬ 
platten. RAM-Disk unter¬ 
stützen Sie 

• schnelle Directory-Anzeige 

• Sie können Disketten leicht 
nach Texten, Bildern u.ä. 
durchsuchen 

• Dateien lassen sich mit 
Pause/Continue-Möglichkeit 
betrachten 


• Ausdrucken von Dateien auf 
Drucker 

• Informationen über die Dis¬ 
ketten (Programmlänge und 
ähnliches) 

• Betrachten von Bildern im 
IFF-Format (inklusive HAM) 
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• Sie können Dateien aus belie¬ 
bigen Verzeichnissen in ande¬ 
re Verzeichnisse kopieren 

• Bildschirmausgabe von 
Dateien in ASCII und in hexa¬ 
dezimaler Form 

• Unterstützung von Jokerzei¬ 
chen bei Disketten- und 
Dateioperationen 

CLImate 1.2 - das unentbehrliche 
Programm für den Amiga-500-, 
Amiga-1000- und Amiga-2000- 
Besitzer. 

Am besten gleich bestellen! 

Hardware-Anforderungen: 
Amiga500,1000 oder 2000 mit 
mindestens 512 Kbyte Haupt¬ 
speicher. Empfohlene Hard¬ 
ware: Farbmonitor. 
Software-Anforderungen: 
Kickstart 1.2 (oder ROM bei 
Amiga 500 und 2000), Work- 
bench 1.2. Eine 3'/2"-Diskette für 
den Amiga 500.1000 und 2000. 
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Amiga Programmier-Handbuch 


Die Autoren: 

JÖRG KOCH, geboren 1967, befindet sich zur Zeit 
in der Ausbildung zum Energie-Anlagen-Elektroni- 
ker. Neben der Ausbildung beschäftigt er sich als 
freier Autor auf dem Spezialgebiet Software- 
Entwicklung unter anderem mit den Programmier¬ 
sprachen Modula und C auf verschiedenen 16-Bit- 
Rechnern. 

FRANK KREMSER, geboren 1967, erwarb auf vie¬ 
len Gebieten der Informatik Grundkenntnisse, die 
er in Form von Programmen und Berichten in Fach¬ 
zeitschriften einem breiten Publikum zugänglich 
gemacht hat. 

Beide Autoren haben 1987 mit einem Lernpro¬ 
gramm für den Amiga den Wettbewerb »Goldene 
Diskette«, unter der Schirmherrschaft von Bundes¬ 
forschungsminister Dr. Heinz Riesenhuber, erneut 
gewonnen, nachdem sie bereits 1986 mit einem 
Programm für den Apple erfolgreich waren. 


Bundesforschungsminister Dr. Heinz Riesenhuber 
übergibt Frank Kremser und Jörg Koch aus Marburg 
die »Goldene Diskette«. 


Der Commodore Amiga bietet 
ausgezeichnete Voraussetzun¬ 
gen für ein professionelles 
Entwickeln von Software. Die 
schnellen Prozessoren garantie¬ 
ren optimale Rechenleistung, 
und das moderne, grafisch 
orientierte Betriebssystem öffnet 
den Weg für eine neue Genera¬ 
tion von benutzerfreundlichen 
Programmen. 

Dieses Buch führt Sie in die 
Interna des Amiga ein. Alle 
System-Bibliotheken, die das 
Betriebssystem zur Verfügung 
stellt, werden ausführlich 
anhand kleinerer und größerer 
Beispiele erklärt. Die Pro¬ 
gramme sind in der offiziellen 
Commodore-Entwicklersprache 
Lattice C geschrieben. Ein eige¬ 
nes Kapitel ist der Installation 
des C-Compilers gewidmet, was 
erfahrungsgemäß gerade Ein¬ 
steigern besondere Schwierig¬ 


keiten bereitet. Um Ihnen das 
lästige Eintippen der Pro¬ 
gramme zu ersparen, liegt dem 
Buch eine 3V2"-Diskette mit 
allen Beispiel-Listings bei. 

Die Autoren beschränken sich 
nicht nur auf eine bloße Aufzäh¬ 
lung der Bibliotheks-Routinen. 
Vielmehr wollen sie aus ihrer 
Praxis heraus die besonders 
nützlichen Bibliotheken und 
Devices vorstellen und das Ein¬ 
binden in eigenen Programmen 
zeigen. Auch auf das Umfeld des 
Amiga wird ausführlich ein¬ 
gegangen. So lernen Sie die 
wichtigen DOS-Funktionen für 
das Ansteuern von Druckern 
oder der SideCar-Harddisk 
kennen. 


Aus dem Inhalt: 

• Die Screen- und Window- 
Bibliotheken 

• Die Zeichen- und Text¬ 
befehle 

• Hardware-Sprites und 
Animation 

• Aufbau und Abfrage von 
Menüs 

• Gadgets 

• Mitteilung von System- 
Meldungen 

• DOS-Funktionen in eigenen 
Programmen 

• Druckerausgabe 

• Befehle zur Sprachein- und 
-ausgabe 

Hard- und Software- 

Voraussetzungen: 

• Amiga 500, 1000 oder 2000 
mit 512 Kbyte RAM-Speicher 

• C-Compiler wie Lattice C 
oder Aztec C 
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